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About This Book 


This book is intended to help customers diagnose VTAM problems. It contains diag- 
nostic procedures and information, which must not be used as programming inter- 
faces. Any references to programming interfaces are for diagnostic purposes only. 


Who Should Use This Book 


System programmers should use this book to analyze a vTAM problem, classify it 
as a specific type, and then describe it to an IBM Support Center. You should be 
familiar with VTAM’s service aids, and you should know how to report problems to 
the 18M Support Center. You should also be familiar with the information in the fol- 
lowing books: 


¢ Network Program Products: General Information, GC30-3350 


¢ Programming System General Information Manual, G229-2228. 


How To Use This Book 


Follow these steps to diagnose a problem: 


1. Determine which licensed program is causing the problem in your network. 
You can get help with this step from Network Program Products Problem Deter- 
mination (SC30-3250), from your branch office, or from the iBm Support Center 
(Level 1). 


e If the problem is in VTAM, TSO/VTAM, Or VSCS, you are using the right book. 


e If the problem is in the hardware or in some other licensed program, you 
are using the wrong book. You should be using the Diagnosis Guide for 
that product. 


2. Use Chapter 1, “Documentation to Collect for All Problem Types” to collect the 
information you will need to report to iBM for all problems, regardless of type. 


3. Use external symptoms to determine the type of problem. Chapter 2, “Classi- 
fying the Problem’s Symptoms” describes these symptoms. 


4. Follow the procedure for your type of problem to find its source (if possible), 
and to continue collecting the documentation that the iam Support Center needs 
to solve the problem. 


¢ Chapter 3, “Procedures for Specific Problem Types” gives diagnosis pro- 
cedures for VTAM problems. 

e Chapter 4, “MVS Procedures for for TSO/VTAM Problems” gives procedures 
for TSO/VTAM problems. 

e Chapter 5, “VM Procedures for VSCS Problems” gives procedures for vscs 
problems. 


Chapters 6, 7, and 8 describe the vTAM service aids you can use to collect the 
problem documentation you need. Go to these chapters to collect output from 
traces and dumps. 


The appendixes contain information you may need to refer to when you are 
diagnosing problems. 
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Note: Appendix C, “Network Flows” describes aspects of the internal proc- 
essing of VTAM. The information in that appendix is provided for problem 
diagnosis purposes only. Customers are strongly discouraged against using 
the information in that appendix for purposes other than those for which it is 
intended. 


Notes: 


a. You may need to see VTAM Operation for the exact syntax for some com- 
mands. 


b. Operating system books can assist you in getting output from operating 
system service aids. 


c. If you have access to a software support data base, you can search for 
your problem in that data base and apply the recommended correction, if 
there is one. 


5. After collecting the necessary documentation, report the problem to the IBM 
Support Center. 


You can find information on how to work with the IBM Support Center, and how 
to carry out their suggestions, in the Programming System General Information 
Manual, G229-2228. 


6. If the problem has not been reported before, Level 1 may forward the problem 
to Level 2. Keep all of your supporting documentation on hand to help the 
Level 2 representative solve your problem. 


Technical terms used in this book are defined in the glossary, beginning on page 
/GLOSS/. 


Symbols Used in This Book 


The following symbols are used in this book to indicate information that pertains to 
a specific operating system: 


MVS/XA Indicates information that applies to Mvs/xa only. 

MVS/370 Indicates information that applies to mMvs/370 only. 

MVS Indicates information that applies to both MvS/xA and MvSs/370, but not to 
VM Or VSE. 

VM Indicates information that applies to vm only. 

VSE Indicates information that applies to VSE only. 


Note: Because vSE/Advanced Functions is one of the licensed programs 
in VSE/System Package, no distinction is made between the two. 


These symbols precede unique information. If a piece of information applies to 
more than one operating system, but not to all of them, more than one symbol may 


precede the information. For example: 


mvs vse This function locates the resource in this network or another 
network associated with a given symbolic name or network address. 


The above information applies to MVS/XA, MVS/370, and VSE. 


Information that applies to a// operating systems is not denoted by a symbol. 
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Artwork Used in This Book 


Figure 1 shows the conventions used in this book to illustrate the parts of a 


network. 
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Figure 1. Conventions Used in Network Illustrations 
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What Is New in This Book (Fifth Edition) 


For mvs: 


xvi 


VTAM Diagnosis 


LU 6.2 support has been added to this book, including new vTam internal trace 
records and dump records for Lu 6.2. 


A new controller, the 3720 Communication Controller with an attached disk, 
allows NCP, MOSS, and csP dumps to be transferred to the disk and transferred 
back to the host when convenient. 3720 disk support is available as a PTF in 
V3R1.1 and as part of the base code in v3r2. 


A new controller, the 3745 Communication Controller, allows bus-switching 
between central control units (CCUs) for twin-ccu 3745s, and allows the 
recording of 3745 network management vector transport (NMVT) alerts in 
LOGREC. 3745 support is available as a PTF in V3R1.1 (the 3720 disk support PTF is 
a prerequisite) and as part of the base code in v3r2. 


The tracing of CPWAIT, CPPOST, CPPURGE, DISP, SCHD, and QUE trace records has 
been streamlined. 


The sscp and PSs vTAM internal trace options have each been split into two 
options (SSCP and NRM, and PSS and ESC). 


Information about VTAM V3R1 for mvs has been deleted. For information about 
VTAM V3Ri MVS, see the previous edition of the VTAM Diagnosis Guide 
(SC23-0116). 


For VM: 


LU 6.2 support has been added to this book, including new vtam internal trace 
records and dump records for Lu 6.2. 


Local area network (LAN) Support has been added to this book, including new 
VTAM internal trace records. 


X.25 support has been added to this book, including new vtam internal trace 
records. 


A new controller, the 3720 Communication Controller with an attached disk, 
allows NCP, MOSS, and csP dumps to be transferred to the disk and transferred 
back to the host when convenient. 3720 disk support is available as a PTF in 
V3R1.1 and as part of the base code in V3A1.2 and v3R2. 


A new controller, the 3745 Communication Controller, allows bus-switching 
between central control units (CCUs) for twin-ccU 3745s, and allows the 
recording of 3745 network management vector transport (NMVT) alerts in 
LOGREC. 3745 support is available as part of the base code in v3R2. 


New VTAM exit data trace entries have been added — DTIVRECX, DTIVRESX, and 
OTIVSEND. 


The tracing of CPWAIT, CPPOST, CPPURGE, DISP, SCHD, and QUE trace records has 
been streamlined. 


The sscp and PSs vTAM internal trace options have each been split into two 
options (SscP and NRM, and PSs and ESC). 


The VSCS DATA, FRE, and GET trace options have been added. 
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e New problem diagnosis procedures for vscs have been added, including: 


— General procedures to diagnose logical unit hang problems (page 94) 
— Procedures for determining device characteristics (page 97) | 
— Procedures for Resolving vu/sP logo problems on an SNA device (page 113). 


¢ VTAM V3R1.2 and later can now use the alert function to notify an operator of an 
actual or impending loss of availability of a resource. vTAmM builds a network 
management vector transport (NMVT) for the alert. The NMVT can be traced with 
the Piu option of the vit. 


e Revisions have been made to vscs storage management to allow the swapping 
and releasing of vscs dynamic storage. 


e Information about VTAM V3R1 for vm has been deleted. For information about 
VTAM V3R1 VM, see the previous edition of the VTAM Diagnosis Guide 
(SC23-0116). 


For VSE: 


¢ Local area network (LAN) support has been added to this book, including new 
VTAM internal trace records. 


¢ x.25 support has been added to this book, including new vtam internal trace 
records. 


¢ Anew controller, the 3720 Communication Controller with an attached disk, 
allows NCP, MOSS, and CsP dumps to be transferred to the disk and transferred 
back to the host when convenient. 3720 disk support is available as part of the 
base code in V3R2. 


¢ Anew controller, the 3745 Communication Controller, allows bus-switching 
between central control units (CcUs) for twin-ccu 3745s, and allows the 
recording of 3745 network management vector transport (NMvT) alerts in 
LOGREC. 3745 support is available as part of the base code in v3r2. 


¢ The format of the message numbers has been changed so that message 
numbers now begin with “ist” instead of the number “5”. 


e The tracing of CPWAIT, CPPOST, CPPURGE, DISP, SCHD, and QUE trace records has 
been streamlined. 


e The DSCD, NRSP, OPER, and RCE entries for the VTAM internal trace have been 
included. 


e The sscp and PSS VTAM internal trace options have each been split into two 
options (SSCP and NRM, and PSS and ESC). 


Where To Find More Information 


Figure 2 on page xviii shows the books in the VTAM v3R2 library, arranged 
according to related tasks. For a description of these books, see the 
“Bibliography” on page 671. The bibliography also lists the titles and order 
numbers of books related to this book or cited by name in this book. 
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Figure 2. The VIAM V3R2 Library 


XVIII = VTAM Diagnosis LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


“Restricted Materials of IBM" 
Licensed Materials — Property of IBM 


Chapter 1. Documentation to Collect for All Problem Types 


What is the Problem Related to? .............000000000000000 0048. 6 
APAR or PTF Number .............0.2..00.0000000 00000000000. 6 
DEVICE TVDC: 2 F8 iets we Os PRE ee ore Bae a ee ee ea 6 
Operator Command oico8 pAacatindte Spee eee ek Ha Be OES ESE ES 6 
Terminal User Action .........00.0.0020 0000000000000 been 6 
VTAM Application Program... ... we 6 
Hardware Error Condition ........0. 2.000000 2b ee eee 7 
SOGING CNANGS: 6 45 foo 42 SEE WEN EA woe bE Re eth ee a baw oN 7 

Documentation for Hardware Failures .........0....0.0..00.0..00000. 8 

Recommendations ............0..0. 000000 0 ce ee 8 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 Chapter 1. Documentation to Collect for All Problem Types 1 


“Restricted Materials of IBM" 
Licensed Materials ~ Property of IBM 


2 VTAM Diagnosis LY30-5601-1 « Copyright IBM Corp. 1984, 1989 


“Restricted Materials of IBM" 
Licensed Materials — Property of IBM 


Chapter 1. Documentation to Collect for All Problem Types 


The following chart describes documentation you should have for all types of prob- 
lems. 


Note: Documentation for the NetView" program’ is included in the chart. 


Component ID V3R1 


Component ID 
VTAM (VSE) 5666-31301-H50 


V3R1.1 


Component ID 

VTAM (MVS/370) 5665-31301-112 
VTAM (MVS/XA) 5665-28901-113 
VTAM (VM) 5664-28001-311 


V3R1.2 


Component ID 
VTAM (VM) 5664-28001-312 
VTAM (VSE) 5666-31301-H52 


V3R2 


Component ID 

VTAM (MVS/370) 5665-31301-204 
VTAM (MVS/XA) 5665-28901-205 
VTAM (VM) 5664-28001-320 
VTAM (VSE) 5666-31301-G69 


Information about the release level of each compo- 
nent is contained in an Access Method Support 
Vector List pointed to by the access method control 
block (AcB). See VTAM Programming for more 
information about the AcB. 


Supply a list of any PUTS and PTFs that have been 
applied to your system. Also, supply a list of 

changes that have been applied to the hardware, 
such aS REAS and ECS. 


Program Update Tape 
(PUT) and Program 
Temporary Fix (PTF) 


lf you have identified a module as the source of the 
problem, supply the PTF eyecatcher if the module 
has one. The PTF eyecatcher is the latest PTF 
number that has been applied to a module. It 
follows the module ID in a dump. 


1 NetView is a trademark of International Business Machines Corporation. 
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List of Changes to the List any application programs, new devices, or 

Network Configuration new levels of the operating system you have 
added. 

Version/Release VTAM V3R1, V3R1.1, V3R1.2, or V3R2 

Number 


System Console/ Hard- Shows all messages sent to or commands 

Copy Log received from the operator. May provide clues as 
to when the system began to have problems. 
(VTAM problems may not be apparent at the time 
they occur.) 


NetView or NCCF Hara- Contains messages routed to NetView or to NCCF 
Copy Log (if using that are associated with an operator terminal. 
NetView or NCCF) 


NetView or NLDM File ; Contains session trace data for specified 
(if using NetView or resources and session awareness data for all 
NLDM) active sessions. 


Application Program Some user-written operator application programs 
Log (if appropriate) produce an application program log. 


VTAM Definition Library | This is a set of definition statements for resources 
in the VTAM network, such as the application pro- 
grams and network nodes. The vTAM definition 
library also contains the start options used to ini- 


tialize VTAM, unless they were entered by the 
system operator. Detailed information about the 
VTAM definition library is in VTAM Installation and 
Resource Definition. 


mvs vM LOGREC This is a data set (mvs) or file (vm) that contains 
records of various types of system failures, both 
hardware and software. For hardware failures, 
LOGREC entries contain sense and status informa- 
tion about the device causing the failure. For soft- 
ware failures, LOGREC entries contain information 
such as the psw, abend code, failing module name 
(when possible), and the general registers at the 
time of failure. LOGREC entries are written each 
time VTAM produces a Supervisor call (Svc) dump. 


vsE SYSREC The vse recorder file (SYSREC) contains error 
records for devices owned by VTAM. SYSREC records 
are printed with the Environmental Recording. 

| Editing, and Printing (EREP) program. 
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Documentation 


Link-Edit Map 


Symptom String 


nays Link Pack Area 
(LPA) Map 
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Description 


mMvslf a VTAM load module is involved in a problem, 
an XREF map of the load module is needed to show 
the location of other vTam modules within that load 
module. To get an XREF map, use the service aid 
LIST (AMBLIST) with the control statement LISTLOAD 
and the parameter OUTPUT=xXREF. This produces a 
listing showing the module (CSECT) names and 
their location within the load module. Specific 
information on how to use the LIST service aid can 
be found in the Service Aids book for your oper- 
ating system. 


vmMoave the VTAM LKEDIT, VSCS LKEDIT, and VTAMMAP 
files that are produced by the installation proce- 
dure for VTAM and VSCS. 


vse Most vTAM modules are link-edited into mul- 
tiple CSECT phases. In some cases, it may be nec- 
essary to determine where within the phase a 
failing module is loaded. To do this you must have 
the link-edit map for the phase. Save the output 
from the initial installation steps for VTAM, as well 
as Maintain System History Program (MSHP) 
linkage editor output from the application of main- 
tenance to the system. 


Some VTAM routines provide a symptom string after 
a failure. 


mvs vm [The symptom string Is put in the system 
diagnostic work area (SDWA), which is printed by 
EREP as part of the LOGREC entries. For more infor- 
mation On LOGREC, see: 


MVS SYS1.LOGREC Error Recording 
VM OLTSEP and Error Recording Guide. 


vse The symptom string is put in the first records at 
the beginning of the svc dump, usually on the first 


page. 


Contains module names and starting addresses of 
modules in SYS1.LPALIB. To get an LPA map, use the 
IBM Service aid LIST (AMBLIST) with the control state- 
ment LISTLPA. Specific information on how to use 
the LIST service aid can be found in the Service 
Aids book for your operating system. When used 
with a link-edit map and a dump, an LPA map will 
enable you to identify a module that is found at a 
specific address within the link pack area. 
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What is the Problem Related to? 


Symptoms are often related to a particular device, command, or update to the 
system. If you suspect this is so, you should tell the Support Center of this relation- 
ship. Here are some possible relationships and the kind of documentation you 
should have for each one: 


APAR or PTF Number 


lf the problem appeared after you applied an APAR fix, supply the APAR number. If 
the fix was a PTF, supply the PTF number. The format of APAR numbers and PTF 
numbers in each operating system is shown below: 


Operating 

System APAR PTF 
OYnannn | UYnnnnn 
OZnnnnn UZnnnnn 


vn vinnnnn [anna 


MVS 
VM 
ae Oe Co 


Device Type 
if the problem is associated with the use of a particular type of terminal or other 
hardware unit, supply that device type (such as 3278 Model 2). If the problem is 
associated with a particular type of communication link, supply appropriate link 
characteristics, such as SDLC, BSC, SNA or non-SNA. Also, identify any recent micro- 
code activity on the control units involved. 


Operator Command 
If the problem is associated with a particular vTAM operator command, supply the 
full command name (such as VARY). Also, note any command operand (such as 
INACT) or a network node type (such as CDRM) that has been definitely associated 
with the problem. 


Terminal User Action 
li the problem is associated with a particular terminal user action, such as IBMECHO, 
USS LOGON, Or pressing the CLEAR key, describe the user action (or sequence of 
actions). 


VTAM Application Program 
If the problem is associated with a vTAM application program that is an 16m licensed 
program (such as CICS or TSO), supply the name of the licensed program. 
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Hardware Error Condition 
Sometimes it is immediately apparent that a problem is related to a specific hard- 
ware error condition. The hardware error might have been detected and reported 
in several ways: 


By an operating system message 
By a VTAM or application program message 
By the system operator 
By a terminal user (an indicator of the error status appears in the operator 
information area, at the bottom of the terminal screen) 
By a VTAM buffer filling up with identical information from one device 

_ Through LOGREC 

Through SYSREC or RMS. 


lf a hardware error occurred, note the failure condition that accompanied it, such 
aS UNIT CHECK Or TIMEOUT 


Note: The 18m Support Center cannot help you with hardware problems. Try to 
solve the problem locally. Use NetView or NPDA if you have it installed, or use the 
system console message, which identifies the affected subarea. If you still need 
help, contact your branch office. 


Coding Change 


The problem may have occurred after a coding change in: 


VTAM network definitions 
Macro usage 
Start options 
User-coded exit routines 
Job control statements. 


If so, supply the macro, the option, and the value specified. Examples are: 


luname LU PACING =1 ON an NCP LU definition statement 


SIMLOGON OPTCD =(ANY,Q) ON an AP/ Macro. 
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Documentation for Hardware Failures 


If you think your problem is related to a hardware failure, use the following tools to 
collect information about the hardware failure: 


SDLC link level 2 test (For more information on the LL2 test, see “Modify SDLC 
Link Level 2 Test’ on page 271.) 


NCP intensive mode error recording (For more information on intensive mode 
recording, see “Modify NCP Intensive Mode Recording” on page 271 and the 
NCP, SSP. and EP Diagnosis Guide.) 


NetView or NPDA, if you use it in your system 
LOGREC (or similar operating system facilities) 


4- SYSREC (or similar operating system facilities). 


Recommendations 


For your problem to be serviced more efficiently: 


S VTAM Diagnosis 


When vTAM messages are symptoms of a problem and your installation has 
written its own version of a VTAM message, Supply the original VTAM message 
when you report the problem. 


When vVTAM or operating system messages are symptoms of a problem, follow 
the recommendations in the appropriate message book. 


Use the available formatting routines for dump and trace output instead of 
unformatted hexadecimal output. 


“iva .,,FOr machine-readable dumps, use the interactive problem control sub- 
system (iPCS), if you have it installed, to format and print the output. You can 
use IPCS to look at the dump online. 


You can also use the following utilities to format and print a dump: 


— jy. 0. , AMDPRDOMP 
an re IKJEFTG1 

— os. PRTDUMP 
“or. DOSVSDMP. 


For VTAM and ncP trace data, use one of the following to format and print the 
output: 


— 2, . TAP Or PRDMP 
= _, TAP or TRAPRED 
= _. TAP Or TPRINT. 


See “Printing Trace Records” on page 223 for more information about these 
trace formatters. 
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¢ Keep on hand supporting documentation that may apply to most problems. 
This includes: 


— Listings of the vTAm tables your installation has defined, such as uss and 
LOGMODE 


— Listings of VTAM application programs and VTAM exit routines 


— A table of destination subareas, explicit route numbers, virtual route 
numbers, paths, and transmission groups 


— Qutboard recorder (OBR) records and miscellaneous data records (MDRs) 
describing network hardware errors. (For more information on these 
records, see “Hardware Error Recording’ on page 300.) 


— A table associating session types, COS names, and cos tables 
-- A listing of VTAM components, as follows: 


mvs A System Modification Program (SMP) configuration data set (CDS) 
for VTAM and TSO/VTAM components (see the SMP book for information 
about SMP) 


vm oave the VTAM LKEDIT, VSCS LKEDIT, and VTAMMAP files that are 
produced by the installation procedure for VTAM and VSCS. 


vse A Maintain System History Program (MSHP) RETRACE listing for VTAM 
components (see the MSHP book for information about MSHP) 


¢ Keep a current list of the network’s physical configuration. 


e If you encounter problems during network activation after installing VTAM or 
changing the network, simplify your operating procedures to a step-by-step 
approach. Use appropriate trace facilities and the vTAM DISPLAY command to 
monitor the process. 


* mvs vm !f your configuration is using SNA network interconnection and you are 
using alias names, keep a fist of the alias names defined to each name trans- 
lation program. 


e If you are using NetView or NLDM, collect session-related data for same- 
network and cross-network sessions. To identify the first occurrence of a 
problem, NetView or NLDM should be running all the time. 


NetView and NLOM collect two kinds of session data: session awareness data 
and session trace data. 


NetView and NLDM collect session awareness data for all active sessions. 
Session awareness data includes: 


— Session type 
— Names of session partners 
— Session activation status 


— Ds of subarea physical units contained in the explicit route assigned to the 
session 


— Transmission group numbers 


— Addresses and network IDs of SSCPs that own links in the transmission 
groups. 
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Session trace data is recorded only for sessions with a resource for which a 
session monitor or NLDM session trace has been started. !t includes: 


— Session activation parameters 
— VTAM PlU data 


~— NcP data. 
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Chapter 2. Classifying the Problem’s Symptoms 
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Chapter 2. Classifying the Problem’s Symptoms 


This book contains diagnosis procedures for VTAM, TSO/VTAM (MVS Only), and VSCSs 
(VM only). For other types of problems (such as operating system, NCP, application 
program, and hardware problems) see the list of appropriate books in 
“Bibliography” on page 671. 


If any of the following caused your problem, this book may not help you: 


e Did you modify an application program that has run without problems in the 
past? 


e Did you change the processing environment? For example, did you introduce a 
new host processor or communication controller? 


¢ Did you modify the operating system, or did you install a new release of the 
operating system? 


¢ Did you add a new terminal to your VTAM network that had incorrect features or 
incorrect Request for Engineering Activity (REA) and Engineering Change (Ec) 
level? 


¢ Did attaching a link cause the problem? 
¢ Did setting switches at a terminal cause the problem? 


¢ Did initializing link parameters for a programmable controller cause the 
problem? 


¢ Did you modify installation-provided vTAm tables? For example, did you modify 
LOGMODE, COS, or uss tables? 


e Did modifying vTAM messages cause the problem? 


This book does not address problems caused by these user activities. You need to 
resolve the problem on your own. 


Note: If you cannot resolve the problem on your own, and if one of the user actions 
listed above resulted in one of the symptoms listed in “Symptom Listing” on 

page 14, follow the appropriate instructions in Chapter 3, “Procedures for Specific 
Problem Types” on page 19 to gather additional information, then call the 1am 
Support Center for assistance. 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 Chapter 2. Classifying the Problem’s Symptoms 13 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Symptom Listing 


Find the symptom you are experiencing in the following list. The symptoms are listed alphabetically. 
Match your symptom to the appropriate vTAm problem type, and turn to the page indicated. If none of the 
symptoms matches yours exactly, choose the one that is most similar. 


Abend message | Page 19 
Activating network nodes takes too long Page 62 
Application program cannot terminate Page 29 
Application programs and terminals cannot communicate Page 29 
Application program reports an unexpected return or sense code Page 57 
Batch application program fails to complete Page 29 
Book contains information that is wrong or ambiguous Page 66 
Book is missing information Documentation Page 66 
Books contradict each other Page 66 
Command is not completed Page 29 
Commands cannot be entered on system console Page 46 
Commands take too long to complete Page 62 
Cursor is in the wrong position Page 57 
Deactivating network nodes takes too long Page 62 
DTl error message Page 53 
DTI message is wrong or formatted improperly Page 53 


Dump file contains a VTAM, TSO/VTAM, or VSCS dump Abend Page 19 
or 
Program Check Page 25 


Error message Page 53 
X'FFF', X'FFB', or X'FED' appears Program Check '0 Page 25 


M This may also be a message probiem. 
L This may also be a /foop problem. 

10 This may also be incorrect output. 

H This may also be a hardware problem. 


OEF This is probably an application program or vTAm definition error, such as using an incorrect LOGMODE definition. 
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Problem Type 
Wait + 


Symptom 


Page 29 
Page 53 
Page 53 
Page 93 
Page 93 
Page 53 
Page 53 
Page 25 
Page 19 
Page 57 
Page 57 
Page 62 
Page 19 
Page 46 


Hung system 
IKT error message Message 
Initialization problem (VSCS only) Chapter 5 


Internal error message (VSCS only) Chapter 5 


iST error message Message 
IST message is wrong or formatted improperly Message '0 


IST2521 message appears Program Check 
IST413! message appears Abend 


Keyboard locks unexpectedly Incorrect Output 
Logo problem Incorrect Output 


LOGON takes too long to complete Performance 
Abend 


SYSREC entries indicate a program check 
SYSREC fills with repeated entries 
System functions stop 
System light is on, Wait light is off 


LOGREC entries indicate an abend 
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Symptom 


[Probiem Tee [See 
Terminal user cannot enter data 
Terminal user cannot log on or off Page 57 
Terminal user gets unexpected response Page 57 
Terminal user reports incorrect or missing data Page 5/7 
Termination problem (VSCS only) Page 93 


Traffic ceases through a network component Page 29 
(BSC link, SDLC link, communication controller, control unit) 


VTAM does not work as described in a book Page 66 
VTAM process issues an error message Message Page 53 
“5” error message Page 53 
“5" message is wrong or formatted improperly Page 53 
5C52I message appears Page 25 


VTAM is not communicating with system console 
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Chapter 3. Procedures for Specific Problem Types 


Mvs vM Abnormal End Procedure ................2...... 00200000404 19 
vVSE Program Check Procedure... ... 2.2... 2 ee 25 
Wait Procedure. ka 24.84 0468. bord d Oe Oem eb eh ht Bee ewe SASS eA 29 

Checking Whether the VARY INACT,FORCE Command Can Complete ..... 44 
[OOO Procedure: s2%45 4445-4 bed awe Be ee Ga hae eee we 46 
MeSSage PrOCedUre. bos 2:5 2s. eo Sn Oe EE Oe he Zh RHSG HE Oe 53 
Incorrect Output Procedure .. 7. 1 ee 57 
Performance Procedure .... 6... 62 
Documentation Procedure ...... 0... .. 2 66 
Failing Module Procedure: ...6i 4. baka dee ee eS edce ees ee ER eee See EY 67 
REDOING PrOCedUIe. 8 fas ele das dome Sew Eee ee TES OE EHR OTS 68 
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Chapter 3. Procedures for Specific Problem Types 


Now that you have classified your problem as a specific type, this chapter shows 
you how to collect the additional information you need when you talk with the IBM 
Support Center. 


Turn to the section that describes your particular problem type: 
¢ “mvs vm Abnormal End Procedure” 
¢ “vse Program Check Procedure” on page 25 
e “Wait Procedure” on page 29 
e “Loop Procedure” on page 46 
e “Message Procedure” on page 53 
e “Incorrect Output Procedure” on page 57 
e “Performance Procedure” on page 62 


¢ “Documentation Procedure” on page 66. 


There are two other sections at the end of the chapter: 


¢ “Failing Module Procedure” on page 67 tells what to do when you have iso- 
lated the problem to a specific VTAM module. You may be sent to this section 
from within the procedure for the problem type you have chosen. 


e “Reporting Procedure” on page 68 describes briefly how to report the problem 
to the 1BM Support Center. 


uvs vw ADnormal End Procedure 


If the problem is an abend, use the procedure in Figure 3 on page 20 tocollect 
the following documentation: 


¢ Dump output 

¢ LOGREC 

¢ Symptom string 

e Abend or system completion code 

e Contents of the general registers (at the time of the abend) 
¢ Module ip and PTF eyecatcher 

e psw (at the time of the abend) 

e vit if available at the time of the abend. — 
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Get dump 
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Figure 3. mvs vm Overview of the Abend Procedure 


Detailed descriptions of the steps involved in the abend procedure begin below. 
1. Get dump output. 


VTAM usually produces a dump for an abend. If no dump was taken, the dump 
files or spools may be full. Check for a message that an error occurred while 
VTAM was trying to produce the dump. If vTAmM was not able to complete the 
dump, you will have to re-create the abend or wait for it to occur again. 
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2. Find the symptom string. 


A symptom string is a structured data base search argument. The symptom 
string gives information about what was happening at the time of the abend. A 
record is written to the LOGREC data set whenever VTAM takes a Supervisor call 
(svc) dump. For about 85% of all abends, recovery routines produce a 
symptom string subset, which you can get by printing LOGREC. The symptom 
string subset, if it occurs, is located in control block SDWA in LOGREC. 


mvs The SdWA address should be listed in the beginning of the dump, in the 
dump abstract information. It is also printed out in LOGREC, labelled “Hex 
Dump of Record” at the end of each software entry. 


The symptom string begins at X'194' in the SowA. Field SDWAURAL gives the 
length of the symptom string, which can be up to 256 bytes. 


vm There are three ways to find the symptom String: 


a. If viT is active, locate the ABND SNAP trace record. This shows the address 
of the SDWA. 


b. If viTis not active, scan the registers shown at the beginning of a dump for 
the address of the SDWA. 


The SOWA can be difficult to recognize. However, the abend code is at + 
X'4', so knowing the abend code before you start looking for the SOWA can 
help. 


c. If neither the trace nor the dump is available, scan the software error 
portion of LoGREc for the symptom string. 


Figure 4 shows an example of a symptom string subset. This example is from 
the comments section, to the right of the SDWA. 


AB/SOOC4 PIDS/566528901 LVLS/113 RIDS/ISTCFCWM 

RIDS/ISTAPCES#R RIDS/ISTCFCR2#L REGS/GR14 FLDS/PSW ADRS/000006C4 
VALU/HB0044770 FLDS/POWPSSQ ADRS/O27F9CBO REGS/OC6A2 REGS/0A018 
VALU/HEQ044770 PIDF/566528901 PTFF/UY09850 PRCS/00000010 


Figure 4. Example of a Symptom String Subset in Output 
The meanings of the fields are given below, in the order in which they occur in 
the example. 
AB Abend interrupt code, such as 0C4. 
PIDS VTAM Component ID. 
LVLS VTAM version and release level. 
RIDS One of three kinds of modules: 


e Recovery module, if followed by .R 
¢ Load module, if followed by .L 
¢ CSECT name of the failing VTAM module, if not followed by anything. 


REGS _ __ The first byte shows the register number, and the next 1.5 bytes show 
the displacement. The displacement value is the difference between 
the value of the Psw I-Address and the content of the register. Each 
REGS field is shown only if the value is less than the Psw, and if the dif- 
ference is less than 4K. 
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FLDS Fields, control blocks, and DSECTs labels 
ADRS Offset into the failing VTAM module. 

VALU Field value or overlay length 

PIDF Software program component ID 

PTFF VTAM service level. 


PRCS Return code 


. Find the abend or system completion code. 


mvs YOu can find the system completion code in the output of several different 
service aids. The mvs system control block RTM2 work area (RTM2WA), the 
SYS1.LOGREC software record, and the Task Control Block (TCBCMPC) contain the 
completion code. The RTM2wWA is pointed to by the TcB of the failing task (field 
TCBRTWA), and is listed after the abending TcB. 


vm You can find the abend code, ABNCODE, in the abend work area, ABNWA. Low 
core X'298' points to the ABNWA. You can also find the system completion 
code in the SDWA in a dump, or you can use the TACTIVE subcommand of the IPCS 
DUMPSCAN Command to display the task completion code. 


. Is the abend code 0Cx? 


If the completion code is of the form OCx (where x = the program interruption 
code from the Psw), continue with this step. If the abend code is not 0Cx, go to 
step 6 on page 23. 


a. Find the program status word (Psw) at the time of the abend. 
The Psw is found in: 


¢ mvs The LOGREC output, the SDWA, or the RTM2WA 
¢ ym The LOGREC output, the SOWA, or the ABNWA. 


The location of the PSw in the dump output varies depending on the type of 
dump taken. For assistance in locating the Psw in dump output, see the 
diagnostic books for your operating system. 


b. Find the failing address. 


The Psw contains either the address of the next instruction to be executed 
at the time of the abend or the instruction that failed at the time of the 
abend, depending on the interruption code. Scan the dump output to find 
the address given in the PSw 


lf you cannot find the address, the dump may not contain the relevant 
portion of main storage. 


c. Find the module ID containing the failing address. 


VTAM identifies modules with the module name, Julian date, and PTF 
eyecatcher at or near the beginning of each module. This module identi- 
fier will be in the form: 


ISTXxxxx yy.ddd nnnnnnn 


where xxxxx is the last five characters of the module name, yy.ddd is the 
Julian date the module was assembled, and nnnnnnn is the latest PTF (if 
any) that has been applied to this module. 


Sometimes vTAM puts the module name of the failing module in LOGREC. If 
itis not there, you can find it in a dump. 
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To find the module !D in a dump, start at the failing address and scan in 
descending address order along the right side of the listing. The module ID 
is printed in EBCDIC. 


cave You can also scan the LPAMAP for the name of the module that contains 
the failing address. 


d. Find the failing instruction. 
Use the address in the Psw to find the instruction that caused the abend. 
e. Find the general registers. 


The general registers in use at the time of the abend are found in: 


e .», The LOGREC output, the SOWA, the abend SvrB register save area, or 
the RTM2WA 

e .. The LOGREC output, the sowA, the abend SvRrB register save area, or 
the ABNWA. 


Use the diagnostic books for your operating system to help find the regis- 
ters. 


f. Determine which register has invalid information. 


The failing instruction often uses a register with an invalid address in one 
of the general registers, or will point to an invalid location (for example, 
low-address storage). Use the Principles of Operation book for your 
processor, the program interruption code from the SDWA (for Mvs) or from 
the Psw (for vM), and the general registers used in the failing instruction, to 
determine (if possible) which register contains or points to incorrect data. 


If the interruption code is 10 or 11, then the PSw address points to the 
failing instruction. Otherwise, back up the Psw by the instruction length, 
and that is the failing instruction. 


Next go to step 9 on page 24. 
5. «> Is the abend code OAB, OAC, OAD, or 15D? 


These abend codes indicate a TSO/VTAM abend. For diagnosis information, go 
to “..vye TSO/VTAM Abends” on page 77. 


6. Is the abend code 0Ax? 


If the abend code is in the form OAx, continue with this step. If not, go to step 7 
on page 24. 


a. Find the abend code explanation in VTAM Messages and Codes. 


An abend code of OAx indicates a problem within the vTAM network. The 
problem could have originated in vTAM, the NCP, an application program, or 
the hardware of some other network component. Look up the code in 
VTAM Messages and Codes. Most 0Ax abends place a return or reason 
code in register 15 at the time of failure. You can find the return code in 
register 15 by using the set of general registers from: 


e -..,; The LOGREC output, the SDWA, or the RTM2WA 
e . The LOGREC output, the SowWA, or the ABNWA. 
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b. Find the address of the module that issued the abend, using the Psw, which 


points to SVC 13. 
Find the module ID. 


From the address determined in the previous step, scan in descending 
address order through the dump to find the module ID (see step 4c on 
page 22). 


Go to step 9. 


7. mvs Is the abend code 80A, 40D, or 202? 


lf the abend code Is one of these, continue with this step. Otherwise, continue 
with step 8. 


These abend codes indicate storage problems. Collect the following documen- 
tation: 


A dump of the vTAM address space 

A dump of the vTAM CSA 

LOGREC output 

VIT output at the time of the abend, if it is available. 


After obtaining this documentation, go to “Reporting Procedure’ on page 68. 


. Is the abend code none of the above? 


mvs A complete list of abend codes is found in the System Codes book for your 
operating system. 


vm The abend codes are in VM/SP System Messages and Codes. 


Fach code has an explanation of the documentation required and the problem 
determination steps to follow. For example, many abends occur during exe- 
cution of svc instructions. Parameter lists and register contents passed to svc 
routines are in the diagnostic books for your operating system. These books 
may suggest that you obtain additional information such as a module name, a 
return code, a register containing invalid information, or the name of a system 
control block containing invalid parameters. After making a complete check of 
these sources, you are ready to report the problem; continue with step 9. 


. Report or go to the failing module procedure. 


If you determined the module ID, go to “Failing Module Procedure” on page 6/7. 
Otherwise, see “Reporting Procedure” on page 68. 
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vse Program Check Procedure 


If the problem is a program check, use the procedure in Figure 5 on page 26 to 
collect the following documentation: 


¢ Dump of VTAM partition and Supervisor 

¢ Message information 

¢ Contents of the general registers (at the time of the error) 
¢ Module ID and PTF eyecatcher 

* psw (at the time of the error). 
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Figure 5. yse Overview of the Program Check Procedure 


Detailed descriptions of the steps involved in the program check procedure begin 


below. 


1. Get dump output. 


In the hard wait cases, use the formatting option to print the VSE Supervisor 
areas and the VTAM partition. Since VTAM programs are not executed in the 
shared virtual area (SVA), it is not usually necessary to print the SVA for VTAM 


problems. 


lf the dump was produced by the vse terminator upon cancelation of VTAM, it 
will produce a dump of both the vSE supervisor and the VTAM partition (if // 
OPTION DUMP.SYSDMP was specified in the vTAm procedure). A dump produced 
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using // OPTION PARTDUMP will not contain all of the vSE supervisor areas used in 
performing VTAM functions. 


See the VSE Service Aids book for more information on obtaining and format- 
ting VSE dumps. 


2. Find the symptom string. 


A symptom string is a structured data base search argument. The symptom 
string gives information about what was happening at the time of the program 
check. A record is written to the SYSRECc file whenever VTAM takes an svc dump. 
For about 85% of all program checks, recovery routines produce a symptom 
string subset, which you can get by printing SYSREC. 


Recovery routines produce the symptom string if storage is available for it. 
The symptom string subset, if it occurs, is located in the first records of the svc 
dump output, usually on the first page. Figure 4 on page 21 shows an 
example of a symptom string subset in dump output. 


3. Locate the point of faijure. 


a. If the program check was reported by message 0S03!, the exception type 
and location are contained in the message text. 


b. For hard wait states (X'FFF' and X'FFB'), the failing instruction address 
can be determined from the program check old Psw (see the VSE Service 
Aids book for the location of the PSw in DOSVsDMP format). 


c. For task termination messages other than oso3i, find the save area con- 
taining the error psw and registers (in the beginning of the task termination 
dump). 


d. For message !ST252! (or 5C521, for VTAM V3R1 Or V3R1.2) with return code 36, or 
VSE message ovosi, the canceled task is vVTAMRAP, but the save area used is 
not the normal subtask save area. Instead, the vSE program check handler 
stores the psw and registers at label SVPCSAVE. 


e. For message IST252! (or 5C52I, for VTAM V3R1 Or V3R1.2) with return code 20, the 
VSE dump of VTAM will be taken under the main task. Locate the vTAMAP 
save area either by finding its TcB in the VSE supervisor dump or by using 
location 10 to find the ATCvT and field ATCFLDA to locate module ISTINCFO, 
which contains the save area. 


identify the save area by the name vtamap”p in the first 8 bytes. This is the 
save area of the routine that generated the dump. 


The save area identified by the JOBNAME in the next 8 bytes contains the 
PSW and registers of the failing task. 


f. For wait state X'FED', use the address in register 5 as a failure address. 
4. For WAITFFF and walitFrs, determine if the failure is in the vSE supervisor. 


Though the cause of the problem may not lie in vVTAM, there are several things 
to consider in making that determination. 


a. Check the vse supervisor listing and include the label preceding the point 
of error in your information for the Support Center. If the logic pertains to 
a VTAM function, the problem may be in VTAM. 


b. If the instructions have been overlaid by data, try to identify that data from 
its contents, and note where the overlay begins and its length. If the 
overlay contains terminal data or a recognizable vTAm control block, the 
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problem is probably in vTAmM. Save any pertinent information about the 
overlay to discuss with the ism Support Center. If the overlay is deter- 
mined to be a VTAM control block, the name should be given to the Support 
Center. 


c. If the last interruption was a VTAM Svc 49 or Svc 53, add that to the informa- 
tion in the form SVCxx. 


If the last interruption was some other vse Svc issued by vTam, then VTAM 
may be issuing the Svc incorrectly. Add that information in the form svcxx. 


Proceed to step 5, using the address in the svc old psw as the failure 
address. 


d. if the last interruption was an 1/0 interruption from a VTAM-owned channel- 
attached device, the problem may involve one of the vTAM appendage rou- 
tines. 


e. For the FFs condition, try to determine what was being referred to that 
caused the page fault. If the exception address at location 90 points to an 
area in the VTAM partition, the problem may be in vTAm. If the address is 
within a VTAM module (appears to be executable code), identify the module 
as in step 6. If not, try to identify it as a VTAM control block, using the list of 
control block 10s in Appendix E, “Storage and Control Block ID Codes” on 
page 657. If successful, add the control block name to your list of doc- 
umentation. If not, the area should be either in a vTAM module (see step 6) 
or in a VTAM buffer pool (see Appendix A, “Finding VTAM Buffer Pools”). 


5. Determine which register contains or points to incorrect data. 


The failing instruction normally has an invalid address in one of the general 
registers, or points to an invalid location (for example, low storage). Use the 
Principles of Operation book for your processor, the program interruption code 
from the psw, and general registers in the failing instruction to determine (if 
possible) which register contains or points to incorrect data. Add this register 
number string in the form REGnn to the information for the Support Center. 


6. If the failing instruction address found in step 3 on page 27 is in the vTAM parti- 
tion, identify the failing vTAM module. 


Most vTAM modules are identified by a field containing the name !sTxxxxx and 
the Julian date near the beginning of the module (for example, ISTACCQ4 86.175). 
To locate this identifier, scan the dump in descending address order from the 
point of failure. The identifier will be printed in Escoic along the right-hand 
side of the dump. Add the module name to your documentation list. Go to the 
“Failing Module Procedure” on page 67 to continue obtaining information for 
the Support Center. 


7. Report or go to the failing module procedure. 


If you determined the module ID, go to the “Failing Module Procedure” on 
page 67. Otherwise, go to “Reporting Procedure” on page 68 for information 
on contacting IBM. 
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Wait Procedure 


If the problem is a wait, use the procedure in Figure 6 on page 30 to collect the 
following documentation: 


e 1/0 trace output 
e Buffer contents trace output 
e Session trace data (if using NetView or NLDM) 
e Session awareness data (if using NetView or NLDM) 
¢ Dump output: 
— '™YS Dump of the VTAM address space and CSA 
— YM Dump of the VTAM virtual machine 
— VSE Dump of the VTAM partition and VSE supervisor 
¢ List of: 
— Waiting Process Anchor Blocks (PABs) 
— Waiting Request Elements (wREs) and associated event IDs (EIDS) 
— Waiting Request Parameter Headers (RPHsS) 


¢ For problems associated with an application program: 
— Output from the vit (all options except LOCK) 
— RPLS or FMCBS queued to the ACDEB 


e For problems associated with the network: 
— Output from line trace, generalized Piu trace (GPT), transmission group (TG) 
trace, or (for 3720, 3725, and 3745 only) the scanner interface trace (SIT). 
— VSE Dynamic trace of communication adapter (if available) 
— NCP, MOSS, or CSP dump 
— Reports from NetView, NCCF, NPDA, IMR, Or EREP (if available) 


Note: Use the documentation you have available, unless you need to re-create the 
problem. In that case, make Sure the above traces are active. 
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* Issue DISPLAY ID, DISPLAY PENDING, 
DISPLAY BFRUSE, ond DISPLAY SESSIONS. 
e Check results of operator recovery action. 
* Get buffer trace and VIT. 


* Use NPDA (NetView), EREP, and IMR. 

e Note any message on system or NCCF 
(NetView) log. 

¢ Get VIT, 1/0, line, GPT, and TG trace output. 

e Get session trace dota. 
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Figure 6. Overview of the Wait Procedure 


30. =VTAM Diagnosis 


Detailed descriptions of the steps involved in the wait procedure begin on page 31. 
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1. Determine the extent of the wait condition. 


Determine how extensive the wait state is in the operation of the vTAmM network. 
Determine whether all vrAmM processing stopped or only processing with 
respect to a single device, or something in between. Also determine what, if 
any, recovery action was taken at the time the wait was encountered by the 
operator or user. Some information about the activity that immediately pre- 
ceded the wait may be available on the system log or in application program 
transaction logs. | 


2. Did a logon, logoff, or command fail to complete? 


If so, continue with this step; otherwise, go to step 3 on page 32. 


a. 


If the wait condition was actually the failure of a VTAM procedure to com- 
plete, use the DISPLAY ID command to identify the status of VTAM resources at 
the time of the problem. Note any status codes that are abnormal. 
(Resource status codes are explained in VTAM Messages and Codes.) 


. Use the VTAM DISPLAY PENDING, DISPLAY SESSIONS, Or MODIFY {OPD commands to 


identify Oo requests for which VTAM is awaiting a response from a network 
node. Sometimes a network node appears in a pending state awaiting the 
completion of activity at a higher- or lower-level node (for example, PsuB1, 
PTRM2). The pending status on the other node is needed in such a case. 


. Use the VTAM DISPLAY BFRUSE command to get information about VTAM buffer 


pools. Save the output for use later in this procedure. 


. A VTAM operator may have attempted a recovery action (such as issuing a 


VARY INACT,FORCE Command; “Checking Whether the VARY INACT,FORCE 
Command Can Complete” on page 44 shows how to determine whether 
this command completed.) If the recovery action did not reset the state of 
the node for which the original command was issued, note any lack of 
change to the node status. 


. If VTAM is waiting for an Oo response, look at the output of the vTAM buffer 


contents trace (assuming it was active when the problem occurred). If the 
trace shows that vTAM did send a request and is expecting a response, the 
problem is probably in another network node. 


. You can get additional information on the status of a command from the 


VTAM internal trace (vit). With the sscp and PiU options, you can match 
requests and responses and determine any requests that are outstanding 
(that is, for which responses have not been received). The sus option sup- 
plies information about resource usage, and the pss option provides infor- 
mation about VTAmM’s scheduling of the dispatching process. (See 

Chapter 8, “Using the VITAM Internal Trace” for a description of the 
internal trace entries.) 


At this point you may have enough documentation to report the problem to the 
Support Center. If so, go to “Reporting Procedure” on page 68. Otherwise, go 
to step 5 on page 35. 
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3. Is network traffic stopped through a specific node? 


If so, continue with this step. Otherwise, go to step 4 on page 33. 


a. 


Add the specific node type to your problem documentation. For example, 
the node could be a 3705, a 3720, a 3725, a 3745, a 3790, or a 3274. 
NetView, NPDA, and EREP facilities show whether errors have been recorded 
for the node in question. Session trace data (collected by NetView or NLDM) 
shows whether the node is not responding to vTAM, or whether VTAM is dis- 
carding the responses. Consider using NcP intensive mode recording (IMR) 
for recurrent problems of this type. 


. Note any messages on the system or NetView command facility log 


reporting ER-INOP Outages or other failures. Use the vit trace, or use the I/o 
trace with the EVERY operand, to trace the network flow up to the point of 
failure. NetView, NPDA, MVS VM LOGREC, and VSE SYSREC show the reason for 
the INOP. 


. For NcP-related problems, use the line trace or generalized piu trace if the 


affected node is in an adjacent subarea. Use the transmission group trace 
to record intermediate node flows up to the point where the problem 
occurred. 


. If the problem may be in NcP software or communication controller hard- 


ware, obtain a dump of NCP storage. If the wait affects only part of the 
network, use the dynamic NcPp dump facility. It allows the rest of the 
network to continue operating while the dump is taken. If the failure 
requires reactivating the NcP, use the MODIFY DUMP command. (See 
“Network Control Program (NCP) Dump” on page 274 and the NCP, SSP, 
and EP Diagnosis Guide for more information on NCP dumps.) 


lf the NCP is hung, or the hung resource is attached downstream of an NcpP, 
see the NCP, SSP, and EP Diagnosis Guide for information on hung 
resources. 


. VSE If the problem is in a device attached to the communication adapter, 


use the dynamic trace of the communication adapter to obtain information 
about line-related errors. See VSE Service Aids for more information on 
this trace. 


. If the problem is in a channel-attached device or a channel-to-channel 


attachment, examine one of the following traces, if available, to determine 
the sequence of events preceding the wait. (If no trace output is available, 
you will have to re-create the problem to get it.) 


e vit trace with the cio option 

° MVS CCWTRACE 

® VSE SDAID I/O and CCWD traces 

¢ VM CPTRAP SIO and I/O trace 

¢ vM CP virtual machine trace with 1/0, SiO, Ccw, and CSW. 
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The books listed below contain more information on operating system 1/O 
control blocks: 


e MVS Service Aids and MVS Handbook 

e VM/SP System Programmer's Guide (for VM R4) 

¢ VM/SP Facilities for System Programming (for vM R5) 
e VSE Service Aids and VSE Handbook. 


g. If enough information is available, go to “Reporting Procedure” on 
page 68. Otherwise, go to step 5 on page 35. 


4. Is it a session or application program wait? 


If the wait condition appears to be related to a particular VTAM application 
program, continue with this step. Otherwise, go to step 5 on page 35. 


a. Enter the DISPLAY ID command for the application program, using the EVERY 
Or SCOPE=ALL operand. If there are any nodes with status ACT/u, re-enter 
the DISPLAY command. If you are again informed that the status of a node is 
ACT/U, isSue VARY INACT,FORCE for that node. If you still have a wait condi- 
tion, continue with the next step. 


b. Find out if the problem is in vTAM. If only one application program is 
waiting while others continue to communicate with vTAM, that application 
program probably contains an error. To determine what caused the 
problem, obtain a dump of the application program and the operating 
system supervisor at the time of the problem. 


e Make sure that the error is not an operating system error. (Use the 
diagnostic books for your operating system.) 


e If possible, use the dump to determine the reason the application 
program is waiting. If the application program is not waiting for VTAM, 
use the documentation for the application program to determine the 
reason for the wait. If the problem is in TSO/VTAM, go to 
Chapter 4, “MVS Procedures for TSO/VTAM Problems.” If the problem 
is in vScs, go to Chapter 5, “VM Procedures for VSCS Problems.” 


c. If VTAM still seems to be the cause of the problem, you will need output 
from the vTAm internal trace (vit) to obtain a record of activity on the failing 
session. (If the vit trace was not running at the time of the failure, you 
should re-create the problem with the viT active.) 


e If all application program sessions are hung, a small amount of trace 
data will be produced, and you can collect it all with MODE= INT. 


e If only part of the network is affected, a large amount of trace data may 
be produced, and MODE =ExT is recommended. 


See Chapter 8, “Using the VTAM Internal Trace” for more information on 
using the internal trace. You may also use the 1/o or buffer contents traces 
with ID= application program name specified. 


d. Find the address of the vTAM ACDEB for the application program, or the 
address of the vTAM APPCB for LU 6.2 applications. 


You can find an ACDEB or APPCB associated with an application by using the 
SES(appIname) option of VTAMMAP. If VTAMMAP can not be run then all 
ACDEBS are queued out of the ATCvT from the field ATCACDA. Sorry, there is 
no chain of APPCBS. 
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e. For LU6.2 applications using the aPpPpccmMo interface, go to step 4f on 
page 35. 


For non-u 6.2 applications, continue with this step. 
1) Use the AcbEB’s address to find it in the dump. 
On the FMCB RECEIVE ANY queue, ACDRAFO points to the first FMcB. 
On the RPL RECEIVE ANY queue, ACDRARQ points to the first RPL. 
Notes: 


a) lf there are FMCBS (ACDRAFQ # 0), but no RPLS (ACDRARQ = 0), a 
problem has prevented the application program from issuing 
RECEIVES. 


b) If there are RPLS (ACDRARQ # 0), but no FMCBs (ACDRAFQ = 0), there 
may be a problem involving the continue any/continue specific 
(CA/CS) state of the session. (See VTAM Programming.) 


2) Get the Lucs address (field ACDLUCBA in the ACDEB). 


3) Get the address of a chain of Fmcs extensions (field LUCFMCBA in the 
LucB). Each FMcB extension represents one LU-LU session. 


4) Each Fmcs extension contains a pointer (field TSPFMCBA) to the address 
of an associated FMCB. Find the FmMcBs associated with hung sessions. 


5) In those Faces, look for: 
e The carcs indicator (in TSPPSFL1 and TSPPSFL2) 


e The data queues (in TSPACCUM, TSPEWAIT, TSPEWORK, TSPNWAIT, 
TSPNWORK, TSPEDATA, TSPNDATA, TSPTSOP, and TSPTSIP) 


e Session state flags (in TSPSESSR, TSPDOTSR, TSPCRVSR, and TSPRORSR). 


6) Determine whether there are any indications of unusual conditions. 
(See VTAM Data Areas for more information on the fields in the FMcB.) 


Make a cross-reference listing of network addresses and node names 
to correlate the ViT PiU and 1/0 trace entries with VTAM session control 
blocks, such as the LUCB and FMCB. 


7) If enough information is available, go to “Reporting Procedure” on 
page 68. Otherwise, go to step 5 on page 35. 
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f. For the LU 6.2 applications using the APPCCMD interface: 
1) Use the appcs’s address to find it in the dump. 


On the queue of RABs in continue any (CA) mode, APPRBDAT points to the 
first RAB. 


On the RPL RECEIVE ANY queue, APPRANYQ points to the first RPL. 
Notes: 


a) If there are RABS (APPRBDAT + 0), but nO RPLS (APPRANYQ = 0), a 
problem has prevented the application program from issuing 
RECEIVES. 


b) lf there are RPLS (APPRANYQ # 0), Dut NO RABS (APPRBDAT = 0), there 
may be a problem involving the continue any/continue specific 
(CA/CS) state of the conversation. (See VTAM Programming.) 


ae) 


Find the chain of RABs in the APpPcB (field APPRABC). Each RAB repres- 
ents a conversation. The session associated with the conversation is 
represented by a SaB and is pointed to by RABSABPT. Find the RABsS 
associated with hung sessions. 


3) In those RABs, !ook for: 


~~ 


e The CaA/Ccs indicator (in RABCMODE) 
¢ The data queues (in RABNDATQ and RABCONV) 
¢ The conversation state (RABPSFSM). 


4) Determine whether there are any indications of unusual conditions. 
(See VTAM Data Areas for more information on the fields in the RAB.) 


Make a cross-reference listing of network addresses and node names 
to correlate the ViT PiU and I/O trace entries with VTAM session control 
blocks, such as the RAB. 


= 


If enough information is available, go to “Reporting Procedure” on 
page 68. Otherwise, continue with step 5. 


See the NCP, SSP, and EP Diagnosis Guide for more information on hung ses- 
sions. 


5. Examine system data areas. 


mvs If you have not already done so, obtain a dump of the vTAM address space, 
CSA, and LSQa. Find and analyze the task control blocks. (See Service Aids 
and the Debugging Handbook for information on locating the task control 
blocks. See Diagnostic Techniques for information on analyzing them.) 


vm If you have not already done so, issue #CP VMDUMP, with the appropriate 
options, to obtain a dump of the vTAM virtual machine. 


vse !f you have not already done so, obtain a dump of the vTAM partition and 
VSE supervisor. Find and analyze the task control blocks. (See the VSE Hana- 
book for information on locating the task control blocks. See VSE Service Aids 
for information on analyzing them.) 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 Chapter 3. Procedures for Specific Problem Types 35 


Wait Procedure “Restricted Materials of IBM” 


Licensed Materials — Property of IBM 


6. Check for waiting PABs. 


Look at the following PABs in the ATCVT: 


ATCITPAB internal Trace PAB 

ATCCSPAB Configuration Services PAB 
ATCVDPAB VARY Definition PAB 

ATCPXPAB Buffer Pool Expansion PAs 
ATCPUPASB Physical Unit Services DyPAs 
ATCPUIOP Physical Unit Services 1/0 DYPAB 
ATCLUSRT Logical Unit Services Router DyPAB 
ATCNSPAB No Sessions PAB 

ATCNOSPB Network Operator Services PAB 
ATCSSPAB Session Serialization PAB 
ATCTPMPB TP Message PAB 

ATCTRMPB Termination Subtask DYPAB 


Check the contents of the PASWEaP and PABRPHA fields. The field PABWEQP in 
each PAB contains the address of a chain of work elements that have not been 
processed by vTAm. The field PABRPHA in each PAB contains the address of an 
RPH that is either running or waiting. Note the contents of these fields in each 
of the PAss, and have this information available when you contact IBM. 

Figure 7 on page 37 shows how to find each of these fields. 


Note: In some PABS, PASRPHA may contain the address of an RPH, even though 
the RPH is not running or waiting. 
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Figure 7. Finding PABs Using the ATCVT 
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7. Is the wait caused by pending 1/0? 


a. Use the Input/Output Problem Determination (opp) facility to detect and 
report to the operator I/O operations that have been pending longer than a 
user-defined time limit. (For more information on using IOPD, see “Modify 
Input/Output Problem Determination” on page 270 and VTAM Operation.) 


When a VTAM process is waiting for a response, the process is represented 
by a waiting request element (WRE) queued to an I/O locked queue anchor 
block (LQAB). The WRE points to an event ID (EID), which indicates the 
reason for the wait. (Wait state event ips are described in VTAM Messages 
and Codes.) 


b. Look for the wREs and corresponding EIDs in a dump by using Figure 8 on 
page 39 and the following steps: 


1) Find the atcvt from low-storage addressmvs X'408',vm X'200', orvyse 


2 


3 


4 


5 


~~ 


~—" 


~——— 


~~ 


——” 


X'10'. 


mvs If these low-address locations are not available in a dump, use the 
pointer in the CVT (CVTATCVT) to find the AvT. Location X'00' in the AvT 
points to the ATCVT. 


Get the address of the SSCP 1/0 LQAB in field ATCIOLQB. This is the 
address of the first LQaB. There is one LQAB for each subarea in the 
VTAM network. The LQABs are contiguous in storage. To find the LQAB 
for the next subarea, add X'10' to the address of the previous LQAB. 
To find an LQABs for a particular subarea, multiply the subarea number 
by X'14'. Add the result to the address in ATCIOLQB. 


Scan each Laas at offset X'00' (field LQABFRST) for a non-zero address. 
This is the address of a wre. List these addresses if any are found. If 
a WRE is present, look at wRE + X'04' (field WREQUE) for additional 
WRES queued off the same LaQAB. Again list the addresses of any WREsS 
found. 


Find the waiting event. wREs contain a code (WREIDCD) that identifies 
the waiting event. Use explanations of wait state event Ips in VTAM 
Messages and Codes to find the reason for the wait. The address and 
length of the waiting event are in the wre in fields WREIDP and WREIDL 
respectively. 


Find the Laas. For waiting events other than sscp I/o, there is only one 
LQAB. Using the hex offsets in VTAM Data Areas, find each of these 
LQABS from pointers in the ATCVT: 


¢ ATCLUSMQ 
°° ATCMCQAB 
e ATCPULQB 
¢ ATCNOSQ 

e =ATCSSLQB 


Look for wREs chained off the LaaBs. If a WRE is found, list its address 
and find the associated EID. Use explanations of wait state event IDs in 
VTAM Messages and Codes to find and list the reason for the wait. 
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7) For each wre found, examine the WREDATA field. This field may contain 
a CPCB operation code. If so, look in Appendix D, “CPCB Operation 
Codes” on page 645 to determine the function represented by the 
operation code. Have the function name available when you report the 
problem. (You can also use the IOPD facility to determine the waiting 
event. This facility is described in “Modify Input/Output Problem 
Determination” on page 270.) 
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Figure 8. Waiting Request Elements 
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Find waiting RPHs. 


The following steps give instructions for examining two kinds of wait condi- 
tions: (1) a process is waiting for a buffer, and (2) a process is waiting for some 
other resource. Both kinds of waiting processes are represented by request 
parameter header (RPH) control blocks, but the RPH is found in different 
locations for each type of wait condition. 


e Step 9 explains how to find RPHSs queued from a buffer pool control block. 
These RPHs show that the buffer pool cannot supply the required buffers, 
and as a result, the process is waiting. Note which buffer pool cannot 
supply the required buffers. 


¢ Step 10 explains how to find RPHs that indicate a waiting process. In this 
case, collect the documentation listed in step 10d on page 41. 


. Find RPHs queued from buffer pool control blocks. 


A buffer pool that has no available buffers can cause a wait state. There are 
many reasons for running out of buffers; for example, incorrect allocation in 
the VTAM start options, a VTAM programming problem, or an application pro- 
gramming problem. Use the DISPLAY BFRUSE output obtained in step 2 on 
page 31, if you were able to get it, to analyze buffer pool usage. Otherwise, 
use Appendix A, “Finding VIAM Buffer Pools” to find the buffer pools and 
determine whether any have used all their available buffers. 


Examine locations MVS VM BPCBRPHA and BPCBRPHB or location VSE PCBFRPHA in 
each buffer pool control block. If a non-zero address (indicating a waiting RPH) 
is found at these locations, list the name of the buffer pool associated with that 
buffer pool control block. 


Also, follow the chain at offset X'04' into the RPH to obtain the addresses of 
other RPHS waiting for the same pool. 


Find other waiting RPHs. 


Waiting RPHs indicate a VTAM process that has not been completed. To locate 
the waiting RPHs, look at a formatted dump (in Mvs and vm) or search the large 
pageable buffer pool (LPBUF) by hand. 


MVS Use the VTAMMAP dump formatter with the vTBASIC option. This formats the 
component recovery areas CRAS, which contain the RPHs. 


vm Use the PRTOUMP Command of IPCS and the VTBASIC option. This formats the 
component recovery areas CRAS in a VM environment. 


If you cannot obtain a formatted dump, use Appendix A, “Finding VITAM Buffer 
Pools” to find LPBUF, and use steps 10a, 10b, and 10c to find the waiting RPHs. 


a. Find each allocated buffer in the LP0o buffer pool. The Lp buffer is allocated 
if the high-order bit of the second word is on. Scan each allocated buffer 
for a waiting RPH. The buffer contains an RPH if the value MVS VM X'016C' 
Or VSE X'0168' is shown at offset X'10' into the buffer (offset X'00' into the 
RPH). When you see this value, look at location X'10' into the RPH. A valid 
address at this location (not 1 or FFFFFFFF) indicates a waiting RPH. This 
valid address is the RPH resume address field (RPHRESUM), the location at 
which a VTAM routine will begin executing when posted. Write down the 
RPH address and the resume address. 
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b. Find the remaining buffers in the buffer pool. Look for a waiting RPH in 
each buffer as in the previous step. Continue with this process until the 
end of the buffer pool. If you find any more waiting RPHs, add the RPH 
address and the resume address to your documentation list. 


c. Next look for any RPHs in the LPBUF expansion areas. 
(Appendix A, “Finding VTAM Buffer Pools” explains how to find the 
expansion areas.) If there are no expansion areas, go to step 10d. Other- 
wise, scan each expansion area for waiting RPHs as in steps 10a and 10b. 
Continue adding waiting RPH addresses and resume addresses to the list 
until you have examined all of the expansion areas. 


d. For each waiting RPH, Collect the following information: 


e Address of the RPH 

¢ Resume address associated with the RPH 

¢ Name of the module that contains the resume address 
¢ Starting address of the module in the dump 

¢ PTF number (if it exists) or the Julian date of the module 
e Any locks that this RPH is waiting for (step 11). 


To find the name of the module that contains the resume address, start at 
the resume address and scan in descending address order (upwards) 
along the right side of the dump listing. The module 1D (including the Julian 
date and the ptF eyecatcher) is printed in EBCDIC. 


11. Find reHs waiting for locks. 


a. For each waiting RPH, look at the CRALxPTR fields. If any pointer (PTR) fields 
are non-zero, check the corresponding bit in CRALKACT. For example: 


¢ If CRAL1PTR is non-zero, look at the last bit in CRALKACT. 
e if CRAL2PTR is non-zero, look at the next-to-last bit in CRALKACT. 
¢ {If CRAL3PTR is non-zero, look at the third-from-last bit in CRALKACT. 


If the corresponding bit in CRALKACT is off (zero), the RPH is waiting for this 
lock. If the bit is on (non-zero), the RPH is holding the lock and may be 
waiting for another lock. On your list of waiting RPHs, add the name of the 
lock being held or waited for. (See Figure 9 on page 42.) 


b. If step 11a does not succeed, scan the LPoo buffer pool again, this time 
listing all allocated buffers that contain a non-zero value in field CRALKACT. 
This tells which RPHs own locks, if any, and which locks are held. It is pos- 
sible for a CRA to hold several locks. For example, a value of 06 indicates 
two locks being held: the ROTLOCK (04) and the vocLock (02). (See Figure 9 
on page 42.) 


For each allocated buffer with a non-zero CRALKACT field, look at the 
CRALXPTR fields. (The buffer may or may not contain a resume address.) A 
non-zero pointer field contains a lockword address. Find the lockword. 
The first word of the lockword shows a queue of RPHs waiting for that lock. 
Add these RPHs to your documentation list. 


12. Report the problem. 


Go to “Reporting Procedure” on page 68. 
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DEBLOCK ACDEB ACDLOCK | One per 
OPEN 
applica- 
tion 
program 
HNTLOCK Host Node | ATCHNTLK 
Table 
(ISTHNT) 
sent in FIFO order. 
PDBUFLK ATCVT ATCBUFLK Allows the user to move Common 
data is processed. 
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HNTELOCK| 7 Host Node | HNTELOCK 
Table 
Entry 
HSQCHAIN | ATCVT ATCHSQLK | One 
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in problem diagnosis 
trace data before the 
PSTLOCK ATCVT ATCPSTLK Serializes queueing and Common 
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izes release of PST 
storage. 
Figure 9 (Part 1 of 2). VTAM Locks 
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Wait Procedure 


Hex | Control 
Value} Block Field Name Applies to 
PAB 


— ia 
RDTLOCK ATCVT ATGRDTLK a 


VOCLOCK y ATCVT ATCVOCLK a 


VRLOCK ia VRBLOK 


Figure 9 (Part 2 of 2). VTAM Locks 


Level 1 Lock 
(CRALIPTR) 


Level 2 Lock 
(CRAL2PTR) 


Level 3 Lock 
(CRAL3PTR) 


Level 4 Lock 
(CRAL4PTR) 


Level 5 Lock 
(CRALSPTR) 


Level 6 Lock 
(CRAL6PTR) 


Level 7 Lock 
(CRAL7PTR) 


Level 8 Lock 
(CRALSPTR) 


Level 9 Lock 
CRALSPTR 


Figure 10. Pointers to VTAM Locks 
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PABLOCK 


Serializes queueing and Common 
dequeueing of work ele- 

ments to an extended 

PAB. 

Protects users of CIDCTL | Common 
(PAFIND). Obtained by 

PUNS when a network- 

addressable unit is to be 

added or deleted, ora 

use count decremented. 

1. Serializes Common 
OPEN/CLOSE with VARY. 

2. Serializes VARY Acti- 

vate, VARY Deactivate, 

and VARY ERP. 


Serializes usage of the Common 
VRBLK. 


Lock level held is relative to byte and bit position. 
Byte 3, bit 6 corresponds to lock level 2; 
byte 3, bit 5 corresponds to lock level 3; 


The value of this word corresponds to either 


a hexadecimal value or to a combination 
of hexadecimal values in the table above. 
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Checking Whether the VARY INACT,FORCE Command Can Complete 


lf the operator attempted a VARY INACT,FORCE Command, you should check whether 
the command can be completed or whether there is a VTAM problem. Determine 
this using the following steps according to the resource specified on the VARY INACT 
command. 


1. Channel-attached physical unit or logical unit, SNA or non-SNA: 


a. 


b. 


Display the resource status. If it is PHLIN, PHLAC, PDLUC, or PSUB1, the 
channel is hung or a required interrupt is missing. 
lf the status is PNFYX, go to step 11 on page 45. 


2. Link-attached sSNA logical unit, switched logical unit: 


a. 
b. 


Display the resource status. If it is PNFYx, go to step 11 on page 45. 
if it is anything else, there is a VTAM problem. 


3. Link-attached Bsc 3270 logical unit: 


a. 
b. 


Display the resource status. You should see PDACL or PFDLU. 
Issue VARY INACT,FORCE for the NCP or CA major node that ncp or CA defines 
the device. 


. If the deactivation succeeded and all lower-leve! nodes are inactive, 


message iST105! (or 58051, for VTAM V3R1 or V3R1.2 running under vVSE) will indi- 
cate this. 


. Display the status of all the resources in the NCP or CA major node. 
. If the status is PNFYx, go to step 11 on page 45. 
. If itis anything else, there could be a vTAM or NCP problem. Go to 


“Reporting Procedure” on page 68. 


4. Link-attached sna physical unit, switched physical unit: 


. Display the resource status. You should see PDISC or PFDSC. 


Issue VARY INACT,FORCE for either the physical unit to which the device is 
attached, or for the NCP or CA major node that defines the device. 


. If the deactivation succeeded and all lower-level nodes are inactive, 


message IST105! (or 5805!, for VTAM V3R1 or V3R1.2 running under VSE) will indi- 
cate this. 


d. Display the status of all the resources attached to the NcP. 
e. 

f. If the status is PNFYx, go to step 11 on page 45. 

g. 


If the status is PSUBxX, go to step 10. 


If itis anything else, there is a VTAM problem. 


5. Link-attached BSC 3270 physical unit: 


a. 
. Issue VARY INACT,FORCE for the NCP or CA major node that defines the device. 
. If the deactivation succeeded and all lower-level nodes are inactive, 


g. 


Display the resource status. You should see PDACP or PFDCP. 


message IST105! (Or 58051, for VTAM V3R1 or V3R1.2 running under vse) will indi- 
cate this. 


d. Display the status of all the resources in the NCP or CA major node. 
e. 
f. If the status is PNFYx, go to step 11 on page 45. 


If the status is PSUBx, go to step 10. 


If itis anything else, there is a VTAM problem. 


6. Local SNA or non-SNA major node, switched major node: 


a. 


Display the resource status. You should see PSUBX. 


b. Issue VARY INACT,FORCE for any minor nodes that are not inactive. This 
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7. Link: 


a. Display the resource status. You should see POLNK. 
b. Issue VARY INACT,FORCE for the NCP to which the link is attached. This should 
allow deactivation to be completed. 


8. Channel-attached nce: 


a. Display the resource status. You should see PpIsc. 
b. Press the RESET LOAD button on the communication controller. This should 
allow deactivation to be completed. 


9. Link-attached ncp: 


a. Display the resource status. You should see PsuBxX. 
b. Display the status of the lower-level nodes. 

c. If the status is PNFYx, go to step 11. 

d. lf the status is anything else, there is a VTAM problem. 


10. psusx status: 


a. Display the status of the lower-level nodes to find any pending states. 
b. Deactivate any active or pending nodes. This should allow deactivation to 
be completed. 


11. PNFYx status: 
a. For application programs with an Ns exit: 


if the VARY INACT,FORCE Command is unable to complete, there is a VTAM 
problem. Otherwise, deactivation should complete. 


b. For application programs with only a LOSTERM exit: 


1) If the application program has issued a CLSDST macroinstruction, deac- 
tivation should complete. 


2) If the application program has not issued a CLSDST macroinstruction for 
the logical unit, issue a second VARY INACT,FORCE for the logical unit in 
question. If that does not correct the problem, you may need to cancel 
the application program to allow the deactivation to complete. (Can- 
celling the application program terminates all of the LU-LU sessions 
with the application program.) 


c. For application programs with neither exit: 


Deactivation will not complete until the application program issues CLSDST, 
the application program closes its Acs, or the operator cancels the applica- 
tion program. 


If you came to this procedure from step 2d on page 31, return now to step 2e on 
page 31. 
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If the problem is a loop, use the procedure in Figure 11 0n page 47 to collect the 
following documentation: 
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System console log 


Messages associated with the loop (if any) 


Failing module !D 

Dump output: 

— MVSDump of the vTAM address space 
— VMDump of the vTAM virtual machine 
— VSEDump of the vTAM partition 

Error file output: 

— MVS VMLOGREC 

— VSESYSREC 

For a problem associated with a device: 
— ViT trace output (all except LOCK) 

— W/O trace output (of NCP) 


— Session trace data (if using NetView or NLDM) 
— Session awareness data (if using NetView or NLDM) 
— NetView or NPDA report (if using NetView or NPDA) 


— MVYSGTF CCWTRACE output (if available) 
— VMvym branch trace 

— VMvyscs internal trace 

— Mcp internal trace 

— Mcp virtual machine trace 

— VMccs internal trace 

— YSESDAID CCWD trace output 
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Trace the loop 
and, for re-create, start 
VIT traces 


Are 
you using 


vscs 


Chapter 5 
Yes 


Obtain system console 
and LOGREC or SYSREC 
output 


5 Yes 


Message 
symptom 
i) 


Find 
message ID 


Message procedure 
step 4 


No 


Yes Yes 


i : Get VIT PIU trace, 
lea Link-attached 1/0 trace of NCP, 
9 GEvice or session trace data 


6b No 

VIT CIO trace 
CCW trace, or 

session trace dato, 


No Yes 


Mony 
RECMS PiUs 


received 
° 


Device 
problem 


Trace ERP 
routines 


errors received 
9 


Device 
problem 


Figure 11 (Part 1 of 2). Overview of the Loop Procedure 
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traced 
? 
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and find the 
failing module 


Determine the 
module name 
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the module whose 
address is in 
register 12 


Find the name of the 
module whose address 
is in register 14 


Have 
system trace 
available 


Have VIT Examine the 
available trace output 


Figure 11 (Part 2 of 2). Overview of the Loop Procedure 
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Find the Report or go to 
looping module Failing Module 


names procedure 


Detailed descriptions of the steps involved in the loop procedure begin on page 49. 
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a 


Trace the loop. 


Loop problems may involve many modules or a single module. If possible, 
trace the looping instructions. Using the Operator’s Reference for your host 
processor, instruction-step through the looping addresses. Save these 
addresses for use in diagnosing the problem. 


In an enabled loop (Psw is enabled for interruptions), PSws with low addresses 
may indicate a normal system process. Since most VTAM routines are enabled, 
look for PSw addresses that are in the range of the VTAM address space (MVS), 
virtual machine (vm), or partition (VSE). 


mvs You should also look for addresses within VTAM modules that are in the 
system range (LPA). 


If the VTAM internal trace was running when the loop started, look for any 
exception conditions that might have led to the loop. If the internal trace was 
not running, you will have to re-create the problem to get the trace at the time 
of the loop. Set the internal trace to MODE=ExT to record the trace entries in an 
external file. 


VM Issue DISPLAY PSW, then isSue DISPLAY REGS several times to trace the loop. 
Then, obtain a vm branch trace of the loop, and start the vscs internal trace, if 
you have vscs. (The VSCS trace facility is explained in Chapter 6, “vm Using 
VSCS Service Aids.”) 


VM Look for a vSCS loop. 


lf you are using VSCs, and the loop occurs during VSCS initialization or termi- 
nation, go to Chapter 5, “vM Procedures for VSCS Problems” on page 93. 


If you are using vscs, and the loop occurs at a time other than vscs initializa- 
tion or termination, go to “VM Presentation Services is in a Large Enabled 
Loop” on page 121. If you cannot identify the problem using those procedures, 
return to this procedure. 


MvS If you are using TSO/VTAM, use this procedure. You do not need to go to 
Chapter 4, “mvs Procedures for TSO/VTAM Problems’ on page 71. 


Get dump output. 

Get a dump of VTAM: 
e MVS Issue the DUMP Command, or press the Program Restart key. 
¢ vMIissue #CP vMDUMP, with the appropriate options. 
e VSE Issue the DUMP command. 


If the loop is disabled, the system console will not be available for input, so 
take a stand-alone dump. (See “Mvs Stand-Alone Dump” on page 284.) Print 
the dump output. 


Get the system console log and LOGREC or SYSREC output. 


The system console log may contain information, such as error messages, that 
can help you diagnose the problem. Also, print the LOGREC or SYSREC file. 


Mvs Use the LOGDATA option to print the in-core LOGREC buffers. See MVS 
Service Aids for more information. 
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5. Is a message involved? 


Determine whether there are any messages associated with the loop, such as 
a particular message always preceding the problem, or the same message 
being issued repeatedly. If so, add the message numbers to your problem doc- 
umentation and go to the message procedure, step 4 on page 56. 


Is ita device error? 


For any kind of device error, you should first check the NetView or NPDA report 
(if you have NetView or NPDA) and then the LOGREC or SYSREC output. 


Does the LOGREC or SYSREC output show repetitive entries for the same kind of 
error on a particular device? If so, VTAM is receiving several different errors 
from that device. 


a. If the LOGREC or SYSREC error records are for a link or link station attached 
to a communication controller, get vit piu records and an W/O trace of the 
NcP. If you have NetView or NLDM, get session trace data or session aware- 
ness data for the ncP. If the error records are for a link or device attached 
to a communication adapter, get vit piu records or a dynamic trace of the 
communication adapter. 


lf the trace shows continual arrival of RECMS Pius, then the repetitive entries 
in LOGREC or SYSREC are caused by a device error. 


b. For channel-attached devices, use one or more of the following traces for 
the device to determine whether vTAM is receiving many errors: 


VTAM internal trace with Cio option 

Session trace data (if using NetView or NLDM) 
Session awareness data (if using NetView or NLDM). 
MVS CCWTRACE (if available) 

VM sio and I/O traces for CP and GCs 

VSE 1/0 interruption and CCWD SDAID traces 


If VTAM is receiving many errors, the problem is probably in the device. Try 
to trace the execution of VTAM ERP routines. Then continue with step 7. 


7. Is the loop traced? 


If you were able to instruction-step through the loop, go to step 15 on page 52; 
otherwise, continue with step 8 on page 51. 
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8. Find the failing module. 
Use the Psw to find the failing module. 
The pPsw also is found in: 
¢ mvs The LOGREC output, the SDwA, or the RTM2WA 


When you use PSW RESTART to terminate a looping task, a LOGREC entry is 
created with a completion code of X'071' for the task. An RTM2wWA is also 
created for the task. Use the LOGREC record and the RTM work area to 
locate the failing module. See the diagnostic books for your operating 
system for help in locating the PSw in dump output. 


Depending on the Psw bit 32, the last 3 bytes (24-bit mode) or 4 bytes (31-bit 
mode) of the Psw contain the address being executed at the time of the 
dump. Scan the dump output to find the address given in the Psw. 


For more information on Psws, see the Principles of Operation book for 
your processor. 


Note: Addresses may not always be in numeric order because the dump 
does not always generate output in sequential order. 


If you cannot find the address, the dump may not contain the relevant 
portion of main storage. For example, the address may be in LPA storage. 
Have this portion of storage dumped, or use output from LPAMAP to identify 
the module, and proceed as above. 


e vm You should have found the PSw when you issued DISPLAY PSW in step 1 on 
page 49. 


* vse The location of the Psw in the dump will vary, depending on what type 
of dump was taken. See VSE Service Aids for help in finding the Psw in the 
dump output. 


The last 3 bytes of the PSw contain the address being executed at the time 
of the dump. Scan the dump output to find the address given in the Psw. 


For more information on Psws, see the Principles of Operation book for 
your processor. 


Note: Addresses may not always be in numeric order because the dump 
does not always generate output in sequential order. 


9. Find the module name containing the failing address. 


VTAM identifies modules with an EBCDIC module name and Julian date at or near 
the beginning of most modules. This module identifier will usually be in the 
form: 


ISTXXxxx yy.ddd [nnnnnnn] 


where xxxxx is the last five characters of the module name, yy.ddd is the Julian 
date the module was assembled, and nnnnnnn is the latest PTF (if any) that has 
been applied to this module. 


To find the module 1D, start at the failing address and scan upward (in 
descending address order) along the right side of the dump listing. The 
module ID is printed in EBCDIC. Add the module name to your documentation 
list. 
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Find the module pointed to by register 12. 


General register 12 (X'0C') is normally the base register for vVTAM routines. In 
a VTAM loop, register 12 should point to the same module found in step 11. If 
not, add this module name to your documentation list. 


Find the module pointed to by register 14. 


General register 14 (X'O0E') may point to a module that called the routine that 
is looping. Add this module name to the documentation list. 


Normally, you should add the module names from steps 9, 10, and 11 to your 
documentation list. You can report the problem next, but you may need to con- 
tinue with step 12. 


Get the system trace output. 


The system trace may show many external and i/o interrupts. The psw 
addresses in system trace entries will be part of the loop. 


Get the viT output. 


The vit is useful in determining the reason for the loop, such as a process 
being continually re-dispatched for the same request. Get any viT output avail- 
able. If the vit is not available, and vTAM will accept the command, start the viT 
and specify MODE=EXxT. If VTAM will not accept the command, it may be neces- 
sary to re-create the problem. For more information on the vit, see 

Chapter 8, “Using the VTAM Internal Trace.” 


Examine the trace entries. 


By examining the trace entries, you should be able to determine whether there 
is aloop. The most obvious loops would be a module or modules getting con- 
tinual contro! of the vTAM system, or a control block chaining to itself. Check 
the output of the pss option to see which vTAM routines are getting control. 


If you see a pattern of repetition in the trace entries, it does not necessarily 
mean VTAM is looping. Some VTAM processes are timer-driven and repeat peri- 
odically. Also, the absence of any apparent loop does not necessarily mean 
VTAM is not looping. The loop may not contain a VTAM trace point. 


lf a module or modules are looping, get their addresses from the trace entries. 
Step 15 explains how to find the module name. 


If you find a contro! block chained to itself, or if a queue of control blocks is ina 
cycle, try to identify the contro! block. Most control blocks have a 1-byte ID at 
offset X'00'. See the contro! block 1D codes in Appendix E, “Storage and 
Control Block 1D Codes” on page 657 to identify the control block name. 


Find the module names. 


Use the addresses found in step 14 to find the module names involved in the 
loop. 


To find the module ID, start at the failing address and scan upward (in 
descending address order) along the right side of the dump listing. The 
module iD is printed in EecDic. Add this module id to the documentation list. 
Continue with step 16. 


Report or go to the failing module procedure. 


If you determined the module names, go to “Failing Module Procedure” on 
page 67. Otherwise, you are ready to contact iBm. Go to “Reporting 
Procedure” on page 68. 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


“Restricted Materials of BM” Message Procedure 
Licensed Materials — Property of IBM 


Message Procedure 


If the problem is a message, use the procedure in Figure 12 on page 54 to collect 
the following documentation: 


e ftssuing module 

¢ Message number 

e System console log 

¢ Dump output if required 
¢ viIT output. 


Note: If your installation changed the text of the message, the message ID may not 
be included, or may not match the Ip of the message as it appears in VTAM Mes- 
Sages and Codes. Therefore, it is recommended that you re-create the problem 
using the vTAu-supplied message text. Otherwise, determine what vrAm-supplied 
message text corresponds to the message text your installation is using. 
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Problem Yes 
1 in message 
itself 
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Chapter 4 
No 
Yes 
Chapter 5 
No 
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problem 
? 
4 Identify 
issuing module 
aprtl Yes Failing Module 
5 module procedure 


known 


No 


Figure 12. Overview of the Message Procedure 


Detailed descriptions of the steps involved in the message procedure begin on 
page 565. 
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1. Report if the problem is in the message itself. 


If the content of the message is incorrect or the meaning of the message is not 
clear, go to “Reporting Procedure” on page 68. 


2. Follow the recommended action. 


For all messages, see VIAM Messages and Codes for recommended operator 
and programmer actions. (See the list of VTAM books in the “Bibliography” on 
page 671 for the appropriate form number.) In addition: 


e If the message indicates a storage problem, go to step 3. 


e If the message indicates a TSO/VTAM problem, see Chapter 4, “mys Proce- 
dures for TSO/VTAM Problems.” 


¢ If message DTIS991 indicates a vscs problem, see “yy; Message DTIS99I Indi- 
cates a VSCS Internal Error” on page 135. 


The following list shows message prefixes and the components that issue 
those messages. 


Prefix Issuing Component 

DTI VSCS 

IKT TSO/VTAM 

IST VTAM (MVS, VM, and V3R2 VSE) 
5 VTAM (VSE V3R1 and V3R1.2) 


If the message starts with any other characters, it comes from another network 
component. 


3. Get documentation for storage problems. 


The following vTAM messages may indicate a storage problem: 


Description 


IsT5611 | 5F611 Indicates a buffer pool shortage 
IST5621 5F621 Indicates that CSA has been reached 
IST563I 5F631 Indicates that MAXPVT has been reached 


V3R1 and 
V3R1.2 
VSE 


MVS VM 
and V3R2 
VSE 


IST5641 5F64l Contains the subpool number 
5F65I Contains the subpool number 
5F66l Contains the subpool number 


Figure 13. VTAM Messages Issued for a Storage Shortage 


vse Message !ST561! (or 5F61i, for VTAM V3A1 Or V3R1.2) may be issued when there 
is no problem. For example, a request may come in for a buffer pool before 
the pool expansion request can run. You must display buffer use to determine 
this. 
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lf the message is issued frequently or continuously, get a dump: 


MVS Dump VTAM Common and private storage areas. 
VM Dump the VTAM virtual machine. 
VSE Dump the VTAM partition. 


For messages that give a subpool number, dump the storage containing that 
subpool. 


It is highly recommended that you use a dump formatter. Dump formatters are 
described in “MVS VM Formatting and Printing Dump Output” on page 279. 


After getting the documentation for your storage problem, go to “Reporting 
Procedure” on page 68. 


4. Identify the issuing module. 


Try to identify the module issuing the message. If the MSGMoOD start parameter 
was active or the MODIFY MSGMOD command was issued before the problem 
occurred, the message text contains the last five characters of the issuing 
module name. Add the message prefix to the module name, and add this 
name to your problem documentation. (To modify the module identifier in mes- 
sages, see “Modify Message Module Identification” on page 270.) 


The VTAM internal trace MSG entries contain the message number, the save 
area address, and the module ID (the 4th, 5th, 7th, and 8th characters of the 
module name). Use these to identify the issuing module. If the trace entry 
contains no module identifier, use the caller’s address from the trace entry, or 
find the message issuer by using the message-to-module cross reference in 
VTAM Messages and Codes. 


5. Report or go to the failing module procedure. 


If you know the name of the issuing module, go to “Failing Module Procedure” 
on page 67. If you are unable to determine the issuing module or resolve the 
problem, go to “Reporting Procedure” on page 68. 


2 Although vtam detects storage shortages in the common storage area, VTAM may not be 
causing the shortage since this area is shared by all address spaces. 
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Incorrect Output Procedure 


If the problem is incorrect output, use the procedure in Figure 14 on page 58 to 
collect the following documentation: 


e Specific output that is incorrect 
¢ Device type (if appropriate) 
e Buffer contents trace output 
* vit trace output (all except LOCK) 
¢ Session trace data (if using NetView or NLDM) 
e Session awareness data (if using NetView or NLDM) 
e Network controller line trace output (3710 only) 
° MVS 
— GTF CCWTRACE output (if available) 
— For TSO problem — TGET/TPUT trace 
° VM 
— cP internal trace 
— cP virtual machine trace 
— GCS internal trace 
— For vscs problem — VSCs internal trace 


— SDAID CCWD trace output 
— Communication adapter line trace output 
e Network problem: 
— Line trace 
— Generalized piu trace (GPT) 
— Transmission group (TG) trace 
— Scanner interface trace (siT) for 3720, 3725, and 3745 only. 
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Figure 14. Overview of the Incorrect Output Procedure 


Detailed descriptions of the steps involved in the incorrect output procedure begin 
on page 59. 
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1. Describe the incorrect data. 


Most incorrect output problems pertain to data contained in apiu. This can be 
incorrectly formatted user data, invalid routing information, or other types of 
missing or incorrect data. These types of problems are generally difficult to 
diagnose, as they show up only at the end-user locations. From the following 
list, choose all the symptoms that apply to your problem and add them to your 
problem documentation: 


e Cursor is in the wrong place or missing. 

¢ Format of data is incorrect. 

e Data is truncated. 

e Data is incorrect. 

¢ Data is missing. 

e Problem is related to an application program macroinstruction. 
e Screen is improperly formatted. 

e Session is hung. 

¢ Terminal is hung. 


Note: The term “hung terminal” means the user is prevented by the system 
from entering data. 


2. Determine the device type. 


If the problem is associated with a specific device type, add the device type (for 
example, 3270 terminal) to your problem documentation. 


3. MVS is it a TSO/VTAM user problem? 


If the incorrect output problem involves TSO/VTAM, go to “MVS Screen Manage- 
ment Problems” on page 81. 


4. VM Is It a vscs user problem? 


If the problem involves a vscs user, follow the procedure in “YM Incorrect 
Output Problems” on page 138. 


5. Get network trace and dump output. 
Re-create the problem with the following service aids active: 


Note: For more information on VTAM service aids, see Chapter 7, “Using 
VTAM Service Aids.” Operating system service aids are documented in oper- 
ating system books. 


e Start the vTAM buffer contents trace for the failing application program and 
terminal logical units. 


e MVS If you have an 1BM 3710 Network Controller, start the network controller 
line trace. It traces information passing to and from a 3710. 


e Start the vTAM internal trace with MODE=ExT. (You do not need to use the 
LOCK option unless you suspect that a lock is not working.) This shows the 
type of requests being processed between the application program and the 
end user or terminal, and the control information for routing, pacing, and 
SO On, in each Plu sent in the network. 


e You should start the generalized Piu trace if the problem involves lines or 
devices attached to a communication controller. This will show how far the 
PIU got within the NCP and what the Piu looked like (its control information) 
when it was sent to the line. 
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¢ vse If the problem involves lines or devices attached through a communi- 
cation adapter, start the dynamic trace of the communication adapter. This 
will show any problem related to the line. 


e |f you have NetView or NLDM, you can use the session trace data to deter- 
mine the requests and responses received and sent by vTam and the other 
network nodes. 


* MVS VSE If it is available, you can now use the GTF CCWTRACE (in MVS) or the 
SDAID CCWD trace (in VSE). These trace the ccws, I/O interruptions, and all 
cCw data for each Start Oo issued by the system. For a problem where 
data in the Ru js invalid, this is the only service aid that will show the entire 
Plu. For more information on these traces, see the diagnostic books for 
your operating system. 


¢ As soon after the problem occurs as possible, take a dump of the applica- 
tion program, VTAM, and (in MVS) TSO/TCAS. Stop all traces, and print the 
dump and trace output. 


The dump is used to reference storage addresses, such as control blocks and 
module entry points. The trace data shows at what point the data was modi- 
fied, and what PABs the data was on as it was processed by vTAM. Take the 
dump during the re-create, when the traces are running. A dump taken earlier 
may not be accurate because the terminal device may have been deactivated 
and reactivated. This would allocate a different set of control blocks. 


. Examine the trace output. 


Examine the individual trace entries to find the failure. If the problem concerns 
user data format, and the buffer contents trace or piu trace does not show the 
invalid data, use the output from the vit trace with the Sscp option. 


Mvs The CCWTRACE (if available) can be used to see whether data is correct 
when it goes to the NcP or logical unit. The vTAM internal trace records CC2, Ci2, 
and co2 contain the first 24 bytes of this data. 


When output data is correct: 


If the traces show that the data or the control information in the RH/TH as it 
leaves VTAM is correct, the problem is not in VTAM or the application program; 
go to step 9 on page 61. If the data going to the network is invalid, continue 
with step 7. 


When input data is incorrect: 


If the traces show that invalid data is entering VTAM from an external network 
source, the problem is in the network; go to step 9 on page 61. If the data from 
the network is valid, the problem is in VTAM or an application program; con- 
tinue with step 7. 


. Is it VTAM or an application program? 


The problem has been narrowed down to vVTAM or the application program. 
Examine each trace entry to determine whether the information from the appli- 
cation program was incorrect. If VTAM seems to be responsible, go to 
“Reporting Procedure’ on page 68; otherwise, continue with step 8 on 

page 61. 
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8. Is more application program help needed? 


For IBM application programs Such as CICS or IMS, you may find additional diag- 
nostic help in the iBM application program books. If you decide that the 
problem is with an IBM application program, contact the appropriate IBM repre- 
sentative for that product. 


9. Is the problem with an external network device? 


The problem has been narrowed down to the VTAM network, but not to VTAM 
itself. Try to identify the device or program responsible. You can use service 
aids, such as the ncp line trace, generalized PiU trace, or transmission group 
trace, to trace data flow between the ncP and terminal logical units. For infor- 
mation on how to use these traces, see “Traces Provided by NCP” on 

page 245. For a 3720, 3725, or 3745, use the scanner interface trace (sIT) to 
distinguish between NcP problems and line or terminal problems. If you 
suspect the ncP, see the NCP, SSP, and EP Diagnosis Guide. 


Chapter 7, “Using VTAM Service Aids” explains how to use other service 
aids, including the NcP dump. Contact the appropriate 18m representative for 
the device or program identified as the cause of the problem. 


VSE The communication adapter line trace can be used to discriminate between 
a VTAM error and one that is related to a device or line attached through the 
communication adapter. For more information, see the diagnostic book for the 
host processor. 


10. Report the problem. 


Go to “Reporting Procedure” on page 68. 
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Performance Procedure 


If the problem is performance, use the procedure in Figure 15 on page 63 to 
collect the following documentation: 


e System console log 
¢ Error file output: 
— MVS VM LOGREC 
— VSE sYSREC 
e Tuning statistics 
¢ SMS (buffer use) trace output 
e Network controller line trace output (3710 only). 
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Figure 15. Overview of the Performance Procedure 


Detailed descriptions of the steps involved in the performance procedure begin on 
page 64. 
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Get LOGREC or SYSREC output. 


Performance problems are often caused by hardware errors. These hardware 
errors cause software error recovery processing to occur, which degrades 
system performance. For this reason, you should get LOGREC or SYSREC output. 
LOGREC or SYSREC may show a large number of hardware errors for a particular 
device or group of devices. If the errors are limited to a single device, a hard- 
ware error is probably the cause. If the errors appear on many or all terminals 
of one type, software is more likely to be the problem, although hardware may 
still be at fault. If you suspect a particular device type, add it to your documen- 
tation list. 


. Examine the system console log. 


The system console log may contain messages to help diagnose a problem. 
Add the message ID to the documentation list: 


MVS Document the message ID in the form /STXXxx Or IKTXXXxX. 
VM Document the message ID in the form /STXXXxx OF DTIXXxx. 
VSE Document the message ID in the form 5xxxx (for VTAM V3R1 and V3R1.2) 


Or ISTXXxX (for VTAM V3R2). 


The system console log may also contain information about command prob- 
lems. For example, operator commands might be taking too long to complete. 
Add the command name (for example, VARY ACT) to the documentation list. 


. MVS For TSO/VTAM, see Chapter 4, “MVS Procedures for TSO/VTAM Problems” 


on page 71. 


lf you are using TSO/VTAM, go to “MVS Performance Problems” on page 89. If 
you Cannot resolve the problem with the procedure in Chapter 4, “Mvs Proce- 
dures for TSO/VTAM Problems,” return to this procedure. 


. VM For vscs, see Chapter 5, “VM Procedures for VSCS Problems” on page 93. 


If you are using vSCs, and you have not identified the cause of the problem, go 
to “VM Performance Problems” on page 143. 


. Get tuning statistics. 


If the performance problem is associated with traffic through a channel- 
attached host, a channel-attached communication controller, or a channel- 
attached SNA physical unit, it may be helpful to get tuning statistics for VTAM. 
(For more information on tuning statistics, see “Modify Tuning Statistics” on 
page 272.) 


. Get output from the sms (buffer use) trace. 


You may have enough information to identify the problem. If so, go to 
“Reporting Procedure’ on page 68. If you do not, continue with this step. 


a. Buffer pool expansion can cause performance problems. During VTAM 
initialization, error recovery, and VARY and DISPLAY command processing, 
buffer usage is higher than normal. If buffer expansion is used, buffer 
pools should not expand except during such peak periods. Thus, what 
appears to be high buffer usage could be normal depending on the level of 
system activity. 


Run the buffer use trace (TtyPE=Sms). For information on how to start the 
trace and examine the output, see “SMS (Buffer Use) Trace” on page 237. 
For diagnostic purposes, change the buffer request interval (RACBSNAP) in 
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module ISTRACON to a value of 50 (X'32'). This change causes trace entries 
to be written more often to give a more accurate picture of buffer usage. 


b. Using the time stamps in the system console and buffer use trace, corre- 
late an excessive number of buffer pool expansions or large number of 
buffers used from a single pool with network activity recorded on the 
console. Constant high usage of a buffer poo! may show that not enough 
buffers were allocated at VTAM initialization to properly support the level of 
network activity. Also look for a buffer pool that continually grows; buffers 
may not be released by some VTAM routine. Add the name of a particularly 
active buffer pool (for example, LPBUF or IOBUF) to your documentation list. 


7. MVS Get output from the network controller line trace. 


If an 18M 3710 Network Controller is installed, start the network controller line 
trace. This traces information passing over the lines to and from a 3710. (For 
more information about this trace, see “MVS Network Controller Line Trace 
(3710 Only)” on page 250.) Print the trace output with TAP. 


8. Get additional documentation. 


If no solid indication of a problem is apparent at this point, run the vVTAM 
internal trace (ViT) with OPT=PSS.APILSSCP,.PIU’ and MODE=EXxT. This creates a 
history of vTAM activity. At the time of performance degradation, stop viT and 
take an Svc dump of VTAM. (For more information on the svc dump, see “MVS 
SVC Dump” on page 284.) Print the dump and trace output for future refer- 
ence. 


9. Report the problem. 


Go to “Reporting Procedure” on page 68. 


If you are running an Lu 6.2 application, include the APPC VIT option in this list. 
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Documentation Procedure 


Note: Before using this procedure, be sure that documentation is the problem. A 
VTAM problem may cause the documentation to appear wrong. 


If the problem is documentation, use the procedure in Figure 16 to collect the fol- 
lowing documentation: 


e Incorrect information 
¢ Form number of book. 


Documentation 


Identify the Record the 
incorrect information manua! number 


Figure 16. Overview of the Documentation Procedure 
Detailed descriptions of the steps involved in the documentation procedure begin 
below. 

1. Identify the incorrect information. 


Add to the documentation list the name of the macro, operand, or procedure 
that is incorrectly defined or explained in the documentation (for example, 
“line trace.”) 


2. Record the form number. 


Add the form number of the vTam book to your documentation list in the form 
cennnnnnrr (omitting the dashes in the number; rr is the revision level). For 
example, report the form number of this book as LY30560100. 


3. Report the problem. 
Go to “Reporting Procedure” on page 68. 


Note: Report a documentation problem only when it causes a VTAM problem. 
For suggestions, comments, or questions about VTAM books, use the Reader’s 
Comment Form at the back of the book. 
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Failing Module Procedure 


Use this procedure if you have identified a failing vTAmM module in one of the other 
procedures (abnormal end, message, or loop). Figure 17 shows an overview of 
the failing module procedure. 


Use this procedure to get the following documentation: 


¢ Module tp and PTF eyecatcher 
e Module descriptive name 

e Caller of module 

¢ vit trace output. 


Failing 
Moduie 


Determine 
caller 
of module 


Dispatched 
by PSS 
2 


Locate CRA/RPH 
associated with 
function 


Determine which 
request or command 
invoked the process 


Determine 
the work 
element 


Have VIT 
available 


Report 


Figure 17. Overview of the Failing Module Procedure 


Detailed descriptions of the steps involved in the failing module procedure begin 
on page 68. 
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1. Determine the caller of the service routine. 


The failure may have occurred in a vTAM service routine used for many pur- 
poses. Determine the caller of the service routine. Use the save area con- 
ventions in “Using a Dump to Follow the Execution Sequence of VTAM 
Components” on page 302. | 


2. Examine the work element structure. 


If your problem type is an abnormal end or loop, and the module is dispatched 
under control of vTAM Pss, find the CRA/RPH associated with the process. (See 
step 10 on page 40 in the wait procedure.) The RPHWEA field (at offset X'1C') 
usually points to the work element associated with the process at the time it 
was dispatched. To identify the work element, see “Using a Dump to Follow 
the Execution Sequence of VITAM Components” on page 302. 


From the work element, it may be possible to identify an SNA request/response 
type, an operator command, or an application program request that ultimately 
caused the process to receive control. Add this request or command name to 
your documentation list. 


If the RPHWEA field does not point to the work element, continue with step 3. 
3. Get more trace output. 


Use the vit options pss and sms to get more information about how the failing 
module received contro! or where the relevant control blocks are found. 


Use the last pisp entry for the failing process to get the address of the work 
element and module name of the process entry point. 


Continue with “Reporting Procedure.” 


Reporting Procedure 


Depending on the terms and conditions of your service agreement, you should 
report the problem to either the local branch office or the iam Support Center. 


After asking for your account name and other customer identification, the service 
representative will ask for a brief description of the problem. Your documentation 
list should contain the answers to all questions related to the problem. 


You can find more information about the i8m Support Center and our problem 
solving process in the Programming System General Information Manual. 
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Chapter 4. 1: Procedures for TSO/VTAM Problems 


This chapter shows you what documentation to collect for each type of common 
TSO/VTAM problem. Use this chapter in conjunction with Chapter 3, “Procedures 
for Specific Problem Types” on page 19. 


Note: Most traces discussed in this chapter are described in Chapter 7, “Using 
VTAM Service Aids.” The exception is Svc 93 and Svc 94 entries, which are 
described in the Debugging Handbook, Volume 1. For VTAM and TSO/VTAM command 
syntax, see VTAM Operation. 

To use this chapter, start below and follow the steps. 


1. Are you receiving one or more of the following messages? 


* uSS message 7 ‘LU-name UNABLE TO ESTABLISH SESSION — RU-Name FAILED WITH 
SENSE sense’, or similar USS message 


¢ uss message 10 (the “good morning” message) 
e Message IKT0241 or IKTO19i at the operator’s console 
e Message IkJ60s8! at the operator’s console. 
If so, go to “mvs Logon Problems” on page 73. 
Otherwise, continue with step 2. 
2. Have you encountered one of the following abends? 


e ABENDOAB 
¢ ABENDOAC 
° ABENDOAD 
e ABEND15D. 


lfso, go to “mvs TSO/VTAM Abends” on page 77. 
Otherwise, continue with step 3. 
3. Do you have a hung terminal? 
e The terminal does not respond to any keys you press. 


¢ You must enter data from the terminal before processing will continue (ina 
situation where output is expected). 


If so, go to “mvs Hung Terminal Problems” on page 79. 
Otherwise, continue with step 4. 
4. Are you having one or more of the following screen management problems? 
e Data is in the wrong place on the screen. 


e Data stream errors occur (such as operation checks, commands are 
rejected, PROGXxx). 


¢ Function errors occur (such as incorrect full-screen processing or incorrect 
line prompting in input mode of TSO EDIT). 


¢ Data length is incorrect. 


e Data content is incorrect. 
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If so, go to “Mvs Screen Management Problems” on page 81. 
Otherwise, continue with step 5. 
5. Are you having one or more of the following screen size problems? 
e The terminal does not operate in the expected screen size after you log on. 
e The screen is not always the expected size during a TSO session. 
If so, go to “Mvs Screen Size Problems” on page 86. 
Otherwise, continue with step 6. 
6. Are you having one or more of the following performance problems? 
e Slow response time 
e An increase in the number of detected waits 
e An increase in the number of swap-outs. 
If so, go to “Mvs Performance Problems” on page 89. 


Otherwise, if your problem is not listed in the steps above, it is probably nota 
TSO/VTAM problem. Go back to Chapter 3, “Procedures for Specific Problem 
Types” on page 19 and look for a more likely problem symptom. If you cannot 
find a more likely symptom, go to “Reporting Procedure” on page 68. 
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uvs Logon Problems 
This section provides documentation requirements and diagnosis procedures for 


logon problems. 


The recommended documentation is: 


¢ VTAM buffer contents trace. 


To see the data in the buffer contents trace. set CONFTXT=NO in the TSOKEY0O0 
member of SYS1.PARMLIB before starting TSO/VTAM. 


¢ VTAM internal trace with MODE =EXT and OPTION = (API.PIU.SSCP,MSG). 


The VTAM internal trace may not be required. Review the diagnosis procedure 
for your problem to see if it is required. 


1. Did your first logon using USS commands fail? 
If so, continue with the next step. 
Otherwise, go to step 5 on page 74. 


2. In VIAM Customization, review the process for setting up the uss table and 
using USS commands. Check for the following errors: 


¢ ls your logon command syntax incorrect? 
If so, try to log on using the correct command syntax. 
Otherwise, continue with the next step. 

¢ ls the logmode name incorrect? 


lf the logmode name is specified incorrectly, or if a default logmode entry 
that is inappropriate for the device type is used, you will get USSMSG7. Look 
up the sense code in VTAM Messages and Codes and correct the logmode 
name. 


3. Can you log on to Tso without using USS commands? 
If you cannot log on at all, go to step 4. 


If you can log on, start the vTAm buffer contents trace and log on again. Look at 
the trace output to see what session parameters are contained in the BIND, and 
compare those parameters to the ones in your logmode table. 


lf the session parameters in your logmode table are incorrect, make the neces- 
Sary corrections. Also, make sure the DLOGMOD operand specifies the correct 
logmode table entry. (For more information on defining TSO/VTAM session 
parameters, see VTAM Installation and Resource Definition.) 


If you still cannot identify the problem, go to “Reporting Procedure” on 
page 68. 


4. If you cannot log on at all, and if this is your first logon attempt from the device 
as well as your first logon attempt using USS commands, go to step 5 on 
page 74. 


If you cannot log on at all, and if this is not your first logon attempt from the 
device, go to “Reporting Procedure” on page 68. 
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5. Did your first logon from a particular device fail? 
If so, continue with the next step. 
Otherwise, go to step 7. 


6. Check for an error in the terminal definition statement, the logmode table, or 
the MODEENT macro. (These are described in VTAM Installation and Resource 
Definition.) 


a. If you receive message IKT0241 with return code X'210000' or X'220000', 
the BIND has been rejected. The following steps should help you find the 
invalid portion of the BIND: 


1) Locate the BiNFM in the BIND. BINFM must be X'02' or X'03'. (For more 
information on coding the BIND, see VTAM Programming.) 


2) If a PSERVIC is coded, see VTAM Installation and Resource Definition to 
make sure all fields are coded correctly. 


b. Check to see if the DLOGMOD name is correct on the terminal! definition 
statement. 


If it does not match an entry in the logmode table, the first entry in the 
logmode table is used as the default. The parameters on the default 
logmode table entry may not be appropriate for your device type, and asa 
result, the wrong BIND image may be passed to the logon exit and a CLSDST 
PASS failure may occur. 


Note: You can see this failure in the VTAm internal trace using the Ap! 
option. For more information on the vTaAm internal trace, see 
Chapter 8, “Using the VTAM Internal Trace.” 


c. Check the logmode table entry to see if the parameters are specified cor- 
rectly for your device type. 


If not, the wrong BIND image may be passed to the logon exit and a CLSDST 
PASS failure may occur. 


d. Check to see if the MODEENT macro is defined correctly. 


lf it is not, the terminal may reject the BIND, or the terminal may indicate to 
the logon exit that the terminal is not supported by TSO/VTAM. 


e. If you have not identified the problem, and if users can log on to TsO from 
other terminals, start the vTAm buffer contents trace and check the BIND. 


f. If logons fail for all terminals, or if the BIND in the buffer contents trace is 
what you expected, run the vTAm internal trace with options API, PIU, SSCP, 
and MSG. 


g. If you still have not resolved the problem, go to “Reporting Procedure” on 
page 68. 


7. Did previous logons succeed, but now you cannot log on? 
If so, continue with the next step. 

8. Did you get message iKJ608!? 
If not, go to step 13 on page 75. 


If so, continue with the next step. 
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10. 


11. 


12. 


13. 


. Is message ikJ608! followed by message IKT1041? 


If it was not, go to step 10. 


If if was, a storage shortage prevented the OPEN ACB from completing success- 
fully. This is a VTAM storage shortage, not a TSO/VTAM storage shortage. See 
“Message Procedure” on page 53 for diagnosis information. 


is message 1kJ608! followed by messages IST8041, iST4001, and 1ST8051? 
If so, the CLSDST PASS may have failed. Continue with the next step. 
Is this a cross-domain logon? 

If not, go to step 12. 


If this is a cross-domain logon, make sure each domain has the same number 
of TSO/VTAM APPLIDS defined. 


If one domain has more APPLIDs defined than the other, the CLSDST PASS can fail, 
with an RPLRTNCD and RPLFDB2 combination of X'1453'. (The values of these RPL 
fields are shown in the VTAm internal trace using the API option. For more infor- 
mation on the vTAM internal trace, see Chapter 8, “Using the VTAM Internal 
Trace.”) 


Is there an invalid TSO/VTAM APPLID? (For more information on defining APPLIDs, 
see VTAM Installation and Resource Definition.) 


If so, correct the APPLID. 

If not, continue with step 13. 
Did you get message [KT111!? 

If not, go to step 14 on page 76. 


If so, check the message text to determine the reason for the logon failure. 
See VTAM Messages and Codes for additional diagnostic information. 
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14. Is an ABENDOAB with return code X'0201' or X'0202' associated with the logon 
attempt? 


If not, go to step 15. 


lf so, check the LOGREC entry for additional information. 


Reason aa 
| Code Register Contents 
X'0105' 6 | RPLRINCD, RPLFDB2, and RPLDAF 
RPLFDBK2 (the word of sense) 
X'0201' Bo ACBERFLG (for OPEN ACB failure) 
9,10 TVWA ACB Name (TSOnnnn) 
| X'0202' | 8 ACBERFLG (for OPEN ACB failure) 
TVWA ACB Name (TSOnnnn) 
X'0203' | 5 ACBERFLG (for CLOSE ACB failure) 


6,7 TVWA ACB Name (TSOnnnn) 


Figure 18. MVS ABENDOAB Information in LOGREC 


Then go to “Reporting Procedure” on page 68. 


15. If none of the previous situations apply, start the vTAm buffer contents trace and 
the VTAM internal trace, and trace the logon attempt. Then go to “Reporting 
Procedure’ on page 68. 
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uvs TSO/VTAM Abends 


TSO/VTAM issues several unique abends. This section briefly describes the causes 
and documentation requirements for each one. Use the information provided here 
and in VTAM Messages and Codes to try to resolve the problem. 


lf you are not able to do so, go to “Reporting Procedure” on page 68. 


uvs ABENDOAB 


ABENDOAB occurs when a VTIOC module issues a VTAM macroinstruction that fails. 
Depending on the values of the RPLRTNCD and RPLFDB2 fields, the macro may be 
retried. If the retry fails, ABENDOAB is issued. 


Length Description 
(bytes) 


X'289' RPL request type: X'22' = SEND 


X'23' = RECEIVE 


X08," RPLRTNCD 


X'28B' RPLFDB2 
X'28C' RPLFDBK2 (Sense code) 


Figure 19. MVS ABENDOAB Information in a Dump of SDWA 


If this happens during the execution of a SEND or RECEIVE, the session is placed in 
reconnect status. 


The recommended documentation its: 


¢ Contents of register 15. 


This contains the reason code, which is explained in VTAM Messages and 
Codes. 


¢ Message text for message IKT108I. 


e The software LOGREC entry. 


If you have a LOGREC entry, look at an unformatted dump of the SOWA. 
Figure 19 describes the pertinent data you should look for in the dump. 


¢ The dump that is created automatically for this abend. 


For abends associated with I/O errors, a dump is not generated automatically 
unless the RCFBDUMP parameter of the TSOKEY00 member of SYS1.PARMLIB is Set 
for it. 


e For errors that occur during session initialization or termination, run the VTAM 
internal trace with options API, PIU, MSG, SSCP, and PSS. 
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ABENDOAC 
ABENDOAC occurs when an error halts TCAS processing. 
The recommended documentation is: 
¢ Contents of register 15. 
This contains the reason code, which is explained in VTAM Messages and 
Codes. 
¢ TWARSON (IKTCASWA + X'02'). 
This also contains a reason code, which is explained in MVS System Codes or 
VTAM Messages and Codes. 
ABENDOAD 
ABENDOAD occurs when the TSO/VTAM queue manager has a problem manipulating 
storage for the input and output queues. 
The recommended documentation is: 
e Contents of register 15. 
This contains the reason code, which is explained in VTAM Messages and 
Codes. 
¢ The dump that is created automatically for this abend. 
 ABEND15D 


ABEND15D occurs when the issuer of a TGET, TPUT, or TPG macro passes an invalid 
data area to the Svc 93 modules. A TPUT or TPG request requires read access to the 
area, and a TGET requires write access. ABENDOC4 occurs when IKTVTPUT or IKTVTGET 
tries to validate the data areas passed from the application program, and IKT93EST 
changes the ABENDOC4 to an ABEND15D. 


The recommended documentation is: 


e sLIP dump of the ABENDOC4. 
The SLIP dump is described in the MVS Operator’s Library. 


® GTF trace of SVC 93 entries. 


Note: Either of these will show the invalid address. 
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“vs Hung Terminal Problems 


This section provides documentation requirements and diagnosis procedures for 
problems with hung terminals. Use this information if this problem occurs while 
you are using TSO/VTAM. This procedure will help you determine when the hang 
occurred and what was happening at that time. 


If the problem occurs during logon or logoff, get the recommended documentation 
and go to “Reporting Procedure” on page 68. 


The recommended documentation is: 


¢ vVTAM buffer contents trace. 


To see the data in the buffer contents trace, set CONFTXT=NO in the TSOKEYO0O0 
member of SYS.1.PARMLIB before starting TSO/VTAM. 


e GTF trace of Svc 93 and SVC 94 entries. 


See the Debugging Handbook, Volume 1, for information on interpreting Svc 93 
and SVC 94 entries. 


¢ VTAM internal trace with MODE=EXxT and options AP! and Plu. 
® TGET/TPUT trace. 


The TGET/TPUT trace records all TGET/TPUT/TPG data except address space ID 
TPUTS. 


You can get the TGET/TPUT trace by issuing the MODIFY TRACE command with 
TYPE=TSO. The MODIFY command is described in VTAM Operation. 


e Dump of the nucleus, CSA, and user’s address space. 


If you think you might not be able to re-create the problem, take a dump before 
you try to clear the hang. 


If input (Such as ATTN, RESET, Or ENTER) clears the hang, both a dump and traces 
may be necessary. You may want to start the traces, take a dump with the ter- 
minal hung, clear the hang, and then stop the traces. 


¢ Collect additional general information: 


— Try to determine if the error is related to a certain type of hardware ora 
certain protocol (SNA Or non-SNA). 


— Try to determine if the hang is related to a particular application program 
or type of application program (full-screen, graphics, and so on). 


If so, do other similar types of applications also hang? 
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1. Was the last data that was sent from the application program to VTAM sent to 
the terminal before the hang occurred? 


To determine this, look for a VTAM buffer contents trace entry that corresponds 
to the !ast TPUT trace entry. 


If you see these corresponding entries, the output was sent to the terminal. 


2. If the keyboard locked after data was sent to the terminal, check the outbound 
buffer contents trace entry for: 


¢ Bracketing indicators in RH byte 2 
e Change direction indicator in RH byte 2 


e Write control character to unlock the keyboard in byte 2 of the output 
request unit. 


If an end bracket was sent, the keyboard should be available. 


If a change direction was sent and the keyboard has been unlocked, the key- 
board should be available. 


If a TGET is issued after a full-screen TPUT, TSO/VTAM should unlock the keyboard. 


3. If the keyboard has not been unlocked, see what kind of TPUT was issued last. 
(The option flag bytes in the TPUT entry show what kind of TPUT it is.) 


e For a NOEDIT Or TPG TPUT, TSO/VTAM will not unlock the keyboard. The appli- 
cation program is supposed to send a write control character to unlock the 
keyboard. 


¢ For other TPUT options, is a TGET outstanding? 
If a TGET is outstanding, TSO/VTAM is supposed to unlock the keyboard. 


If no TGETS are outstanding, contact the group responsible for the applica- 
tion program. 


4. If the last activity prior to the hang was input from the terminal, was the data 
passed to the application program? (If it was, the TGET trace entry will corre- 
spond to the inbound vTAm buffer contents trace entry.) 


¢ If so, did the application program ever issue another TPUuT? 


If the application program never issued another TPuUT, contact the group 
responsible for the application program. 


¢ If not, is there anything on the output queue? (Tvwasod points to the first 
output queue element.) 


e {f data has been received by TsosvTam, but it has not been sent to the ter- 
minal, go to “Reporting Procedure” on page 68. 


5. if you have not identified the problem, go to “Reporting Procedure” on 
page 68. 
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uvs Incorrect Output Problems 


Two main types of incorrect output problems are discussed in this section. Screen 
management problems involve mode errors, exception responses, and problems 
with the data on the screen. Screen size problems involve an incorrect or unex- 
pected screen size, either in a particular mode or all the time. Choose the one that 
is most like your symptoms and follow the procedure for that problem. 


mvs Screen Management Problems 
This section provides the documentation requirements and diagnosis procedures 
for problems displaying data on the screen. This section deals with five types of 
screen management problems: 


e Function error (incorrect screen management for mode) 
¢ Exception responses 

¢ Extra or missing data 

¢ Data is not placed correctly on the screen 

e Data appears to be translated incorrectly. 


Choose the one that most closely matches your symptoms and follow the proce- 
dure for that problem. 


Note: Problems with incorrect screen sizes are addressed in “MVS Screen Size 
Problems’ on page 86. 


The recommended documentation is: 


¢ vTAM buffer contents trace. 


To see the data in the buffer contents trace, set CONFTXT=NO in the TSOKEY0O0 
member of SYS.1.PARMLIB before starting TSO/VTAM. 


¢ GTF trace of SVC 93 and SVC 94 entries. 


See the Debugging Handbook, Volume 1, for information on interpreting SVC 93 
and Svc 94 entries. 


¢ TGET/TPUT trace. 


The TGET/TPUT trace records all TGET/TPUT/TPG data except address space ID 
TPUTS. 


You can get the TGET/TPUT trace by issuing the MODIFY TRACE command with 
TYPE=TSO. The mopiry command is described in VTAM Operation. 


¢ Dump of CSA storage and the user’s address space. 


This is only required for address space ID TPUT errors. 
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vivVS The Screen Functions Improperly for the Mode 
1. Review the svc 94 entries to determine the mode. The STFSMODE and STLINENO 
macros set full-screen mode on and off. 


Full-screen mode. 
In full-screen mode, the application handles screen management. 


If the problem relates to full-screen processing, review the information on 
full-screen mode in the TSO Guide to Writing a Terminal Monitor Program. 


lf this does not describe the full-screen processing that you are experi- 
encing, note the differences. 


Line mode. 
In line mode, TSO/VTAM handles screen management. 


In line mode, the data generated by the application program is placed line 
by line down the screen. READY appears on the line below the data, and the 
cursor appears on the line below that. When the screen is full, TSO/VTAM 
sends a page prompt to the screen. When you press the ENTER key, 
TSO/VTAM Clears the screen and sends any remaining data to the screen. 


If you enter data on the next to the last line of the screen, no page prompt 
is sent. Instead, TSO/VTAM clears the screen and reshows the data (or 
command) at the top of the screen. 


If this does not describe the line mode processing that you are experi- 
encing, note the differences. 


2. Report to the group (TSO/VTAM or the application program) that appears to be 


responsible for the incorrect screen management. 


“vs Exception Responses 


82  VTAM Diagnosis 


1. Does the error indicator reflect an error in the RU portion of the PiU (sense = 


1003 or 1005)? 


If so, continue with this step. 


Otherwise, go to step 2. 


a. 


See what kind of TPUT was issued. (This is shown in the flag byte of the 
TPUT trace entry.) 


. For a NOEDIT TPUT, TSO/VTAM Should not change the data provided by the 


application program. Compare the data in the TPuT trace, which starts at 
X'2C' into the trace record, with the vTAm buffer contents trace. 


lf TSO/VTAM has not changed the data, contact the group responsible for the 
application program that issued the TPuT. 


. For a full-screen TPUT, was the data that is causing the error generated by 


the application program? (Data generated by the application program is 
present in the TPUT trace entry.) 


If so, contact the group responsible for the application program that issued 
the TPUT. 


If not, go to “Reporting Procedure” on page 68. 
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2. Look at the error sense code. 


If itis X'800A"', the PiU is too long. This is probably a definition error. In this 
case: 


a. Look in the TH portion of the buffer contents trace entry to find out the 
length of the piu that caused the error. 


b. See how MAXDATA is defined in your Pccu definition statement. The 
MAXDATA value that you code should be as large as the largest Piu that will 
be sent to the terminal by an application program. 


If you have more than one PCcCu definition statement, check to see that the 
right one is being used. 


3. If there are other error indicators, get the documentation shown in step 5 on 
page 59 and continue with that procedure. 


4. If you have not resolved the problem, go to “Reporting Procedure” on page 68. 


mvs Extra or Missing Data 
1. Is the problem with input (data received by the application)? 


a. Is too much data being passed to the application? 


¢ If previous input is added to the end of the current input, the modified 
data tags may have been set improperly in previous TPUTS. Go to the 
“Reporting Procedure” on page 68. 


e If the backspace key, character delete key, or line delete key is not 
functioning properly, look for Svc 94 entries that may have changed the 
default in the STCC macro. 


If this does not account for the problem, get a dump of the nucleus, the 
CSA, and the user’s address space. Then go to “Reporting Procedure” 
on page 68. 


b. Is insufficient data being sent to the application program? 


e Find out which TGET option was used. TSO/VTAM edits data sent from the 
terminal before it passes it to the application program. The type of 
editing that TSO/VTAM does depends on the TGET option. Certain charac- 
ters may be deleted, such as control characters, aid characters, and 
set buffer address (SBA) Sequences. Look at the flag bytes in the TGET 
trace entry to see which TGET option was specified. TGET options are 
described in the TSO Guide to Writing a Terminal Monitor Program. 


e Find out if any user edit exits are involved. User edit exits are listed in 
VTAM Installation and Resource Definition. 


e if you have not resolved the problem, go to “Reporting Procedure” on 
page 68. 
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2. Is the problem with output (data sent by the application)? 


3. 


a. 


Was extra data sent to the screen? 


TSO/VTAM Should not generate any printable data. Compare the data 
portion of the TGET/TPUT trace with the data in the vTAm buffer contents 
trace. 


If you see printable data in the buffer contents trace that is not in the 
TGET/TPUT trace, go to “Reporting Procedure” on page 68. 


lf you see the same data in both traces, contact the group responsible for 
the application program that issued the TPUT. 


Was data from the application lost? 


TSO/VTAM does not generally delete data sent by the application program 
unless it is doing reshow processing. In reshow processing, TSO/VTAM 
deletes the full-screen TPUT and sends a reshow character (X'6E') to the 
full-screen application program. This is shown in the TGET trace entry. 
Compare the data portion of the TPUT trace entry with the data in the vTAM 
buffer contents trace entry to see if any data has been deleted. Determine 
whether this is a TSO/VTAM problem or an application program error and 
contact the appropriate group. 


Note: For more information on reshow processing, see the TSO Guide to 
Writing a Terminal Monitor Program. 


If you have not resolved the problem, go to “Reporting Procedure” on page 68. 


“vs Data Ils Misplaced on the Screen or Page 
Does data wrap around the screen? (Wrapping means that data fills the line 
and splits inappropriately between lines.) 


84  VTAM Diagnosis 


1. 


If it does, continue with this step. 


Otherwise, go to step 2. 


a. 


Find out which TPUT option was issued. Bytes X'12' and X'13' of the TPUT 
trace entry contain the option flags. 


For a NOEDIT TPUT, TSO/VTAM does not edit data, and therefore does not 
change any SBA sequences that may be issued by the application program. 
Contact the group responsible for the application program that issued the 
TPUT. 


For a full-screen TPUT, TSO/VTAM does not generate SBA sequences to place 
the data on the screen. TSO/VTAM changes invalid buffer addresses to print- 
able characters (X'7A'), but this would not cause the screen to wrap. 


If the symptom is incorrect screen size, go to “mvs Screen Size Problems” 
on page 86. 


Otherwise, contact the group responsible for the application program that 
issued the TPUT. 


. If the data was sent without a full-screen or NOEDIT option, go to “Reporting 


Procedure’ on page 68. 
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2. If the problem is not on a display terminal, go to “Reporting Procedure” on 
page 68. 


3. Are SBA sequences correct? Check the type of TpuT that was issued. Bytes 
X'12' and X'13' of the TPUT trace entry contain the option flags. For full- 
screen and NOEDIT TPUTS, the application program usually generates the SBA 
sequences that determine where data is placed on the screen. 


4. Is the buffer address invalid? 


¢ lf the buffer address is invalid for the screen size, contact the group 
responsible for the application program. 


¢ |f an invalid buffer address (shown in the TeuT trace entry) is translated to a 
printable character (X'7A'), the data will go to an incorrect location on the 
screen. 


e lf the buffer address is valid for the terminal in its present screen size, but 
was translated, go to “Reporting Procedure” on page 68. 


5. If this is the first non-full-screen TPuT following a full-screen TpuT, look for an 
SVC 94 trace entry for STLINENO. This macro may be issued by a full-screen 
application to indicate which line the next non-full-screen data should appear 
on. 


If the data was placed by the STLINENO macro, contact the support group for the 
application program that issued the macro. 


6. If you have not resolved the problem, go to “Reporting Procedure” on page 68. 


-s Data Appears To Be Translated Incorrectly 
Incorrect output is the main symptom of this problem. Sometimes the incorrect 
output is colons. The problem is probably related to the TPUT option that was speci- 
fied. 


1. Look at the option flag bytes (X'12' and X'13') in the TPUT trace entry to deter- 
mine what options were used. 


2. See the 7SO Guide to Writing a Terminal Monitor Program to see what editing 
occurs for each type of TPUT option. 


3. If the incorrect output consists of colons, determine what data from the TPUT 
trace entry is being edited into the printable character X'7A', a colon. 


4. See if TSO/VTAM is editing correctly. 


Note: Many applications use TPUT options that do extensive editing and trans- 
lation. This allows many different hardware devices to communicate with the 
application program without causing i/o errors. You may need to write your 
own user edit exits to make sure that all characters that are valid for your ter- 
minals appear on the screen, especially if you are using type 1 logical unit 
devices. 


5. If the editing does not appear to conform to the options specified, check for 
user edit exits or translation tables. (VTAM Installation and Resource Defi- 
nition has a list of these exits.) 


If you have exits or translation tables, verify that they are not causing the 
problem. 
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6. Did the application program send incorrect data to vTAM? The data is shown in 
the data portion of the TPUT trace entry. 


If so, the problem is in the application program. 


7. If you have not resolved the problem, go to “Reporting Procedure” on page 68. 


uvs Screen Size Problems 
This section provides documentation requirements and diagnosis procedures for 
screen size problems. Two major types of errors occur: 


e The screen never operates in the expected size 


¢ The screen is not always the expected size when you change modes. 


Choose the one that most closely matches your symptoms and follow the proce- 
dure for that problem. 


Recommended documentation includes: 


All of the traces may not be required. Read the diagnosis procedure before you 
get them. 


¢ VTAM buffer contents trace. 


To see the data in the buffer contents trace, set CONFTXT=NO in the TSOKEYO00 
member of SYS.1.PARMLIB before starting TSO/VTAM. 


® GTF trace of SVC 93 and SVC 94 entries. 


see the Debugging Handbook, Volume 1, for information on interpreting SVC 93 
and SVC 94 trace entries. 


® TGET/TPUT trace. 


The TGET/TPuT trace records all TGET/TPUT/TPG data except address space !D 
TPUTS. 


You can get the TGET/TPUT trace by issuing the MODIFY TRACE command with 
TYPE=TSO. The MODIFY command is described in VTAM Operation. 
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mvs The Screen is Never the Expected Size 
This is probably a definition problem. 


1. If you are using a USS command to log on, try logging on without it. 


If this corrects the problem, review the use of the uss command in VTAM 
Customization and check the following: 


¢ Is the terminal a non-SNA 3270? 
If itis, does the USS Command include a USSPARM macro for the logmode? 


If So, VTAM ignores the logmode name from the terminal definition state- 
ments and uses its own default BIND image instead. 


¢ Does the uss command establish a default logmode name? 


If so, the default name overrides the name in the terminal definition state- 
ment. 


2. If this is not a USS command problem, check to see if the PSERVIC operand of the 
MODEENT macro is coded correctly. VTAM Installation and Resource Definition 
explains how to do this. 


¢ Are primary and alternate sizes coded correctly? 
e For screen switching, iS BINPRESZ coded correctly as X'7F'? 


3. If you have not identified the problem, look at the BIND that is sent. This is 
shown in a VTAM buffer contents trace of the logon, or in a dump (get the user’s 
address space, nucleus, and CSA, and look at TSBXBIND). 


e If the BIND image is not what you expected, check the LU definition state- 
ment for an incorrect LOGMODE or DLOGMOD parameter. 


e If no logmode table or DLOGMOD operand is specified, no PSERVIC is passed 
to the TSO/VTAM logon exit routine. In this case, TSO/VTAM issues an INQUIRE 
DEVCHAR macro and VTAM indicates that the terminal is a logical unit. 
TSO/VTAM then uses the SCRSIZE operand found in TSOKEYoo. The default 
value for SCRSIZE is 480 (12 rows and 40 columns). 


4. If you have not resolved the problem, go to “Reporting Procedure’ on page 68. 


vs The Screen Is Not the Expected Size for the Mode 
Full-screen mode. The application program controls screen management in full- 
screen mode. The primary (Small) screen size is considered by TSO/VTAM as the 
default size. The application program can control screen size by sending write 
commands in TpuTs that it issues. The write commands are X'F5', erase write, and 
X'7E', erase write alternate. The application program issues X'F5', erase write, 
to set the primary screen size, or X'7E', erase write alternate, to set the alternate 
(large) screen size. 


If neither size is issued, the screen will remain whatever size was in effect when 
the application program entered full-screen mode. 


Line mode. TSO/VTAM controls screen management in line mode. It generally uses 
the large (alternate) screen size when processing TPUTS in line mode. You can use 
the TSO TERMINAL Command and STSIZE macro during a session to change the screen 
size for non-full-screen processing. 
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Using output from the vTam buffer contents trace, the TGET/TPUT trace for TSO/VTAM, 
and the GTF trace of the svc 93 and Svc 94 entries, try to locate the source of the 
problem. 


1. 


Check the svc 94 trace entries to see whether the processing is in full-screen 
mode or line mode. The STFSMODE and STLINENO macros set these modes on 
and off. 


lf the processing is in line mode, go to step 6. For full-screen mode, continue 
with step 2. 


. Note if the incorrect screen size is related to entering or exiting full-screen 


mode. 


. Locate the TpuT trace entry for the data that appears on the screen when the 


screen is the wrong size. Determine the TPuT options for this TPUT and the one 
that precedes it by looking at the option flag bytes. 


lf either is a full-screen TPUT, look at the first data byte. 


lf the first data byte is an escape character (X'27'), the write command that 
follows has been specified by the application program. This write command 
should determine the screen size. 


If the write command is different in the buffer contents trace, go to “Reporting 
Procedure” on page 68. 


. If there is not an escape character in the first data byte, is a write command 


(X'F1t', X'7E', or X'F5') provided? 
lf one of these write commands exists, continue with this step. 
If not, go to the next step. 


If this write command is different in the vTAm buffer contents trace, go to 
“Reporting Procedure” on page 68. 


lf the same write command appears in both traces, contact the group respon- 
sible for the application program. 


if a write command is not provided in the tpuT data, and processing is in full- 
screen mode, does the write command generated by Tso/vTAM set the same 
screen size as the last write command provided by the full-screen application 
program? To determine this, compare the write command in the buffer con- 
tents trace entry with the last one provided in a TPuT trace entry. The write 
command is located in the data portion of the TPUT trace, at X'2C' into the 
entry. 


If the write commands are the same, go to “Reporting Procedure” on page 68. 


lf the write commands are different, contact the group responsible for the appli- 
cation program. 


. If processing is not in full-screen mode, did the STSIZE macro set the screen 


size? To determine this, look in the Svc 94 trace entries. An entry code of 
X'OA' in the high order byte of register zero indicates that the STSIZE macro set 
the screen size. 


If the screen size was set by the application program, contact the group 
responsible for the application program. 


Otherwise, go to “Reporting Procedure” on page 68. 


If you have not resoived the problem, go to “Reporting Procedure” on page 68. 
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uvs Performance Problems 


This section provides documentation requirements and diagnosis procedures for 
performance problems. Use this section along with the information in “Perform- 
ance Procedure’ on page 62. In addition to the documentation required in “Per- 
formance Procedure,” you will need: 


GTF trace of SVC 93 and SVC 94 entries. 


See the Debugging Handbook, Volume 1, for information on interpreting Svc 93 and 
SVC 94 trace entries. 


1. Are wait and hold options slowing response time? 


The application program may be issuing TPUTS and TGETs with the wait or hold 
options. The wait option indicates that the application program should not 
regain control until output data has been placed on the output queue (TPUT) or 
input is available (TGET). A TPUT with a hold option indicates that control should 
not be returned to the application until the data has reached the terminal. 
These options may be necessary for screen management, but prolong 
response time and increase the number of times the address space is 
swapped. 


2. Is an external system resource slowing response time? 


If all users must access the same resource, such as a system catalog, perform- 
ance deteriorates. This problem is especially severe when exclusive ENQs are 
used to control access to the resource. To improve performance, redistribute 
resources. 


3. Are high and low buffer extents set at inappropriate values? 


If the high and low buffer extents are too close together, output wait conditions 
occur. Buffer extents are specified in TSOKEY00, a member of SYS.1.PARMLIB. 
Tune the values of the high and low buffer extents to get optimum perform- 
ance. Tuning is explained in VIAM Customization. 


4. Are appl definition statements coded correctly? 
Code the AUTH=NVPACE operand on all APPL definition statements for TSO/VTAM. 


lf you do not set NVPACE, VTAM indicates that it has already received input data, 
instead of queuing the response until it receives the input data. Also, the swap 
count is incremented by two every time the ENTER key is pressed. 


5. Are pacing values set correctly for local SNA terminals? 


VTAM ignores the NVPACE Operand for sessions with logical units in a local 
major node. Therefore, you must set non-zero pacing values for these logical 
units. 


6. Is the mvs performance group specified correctly? 


Set the application program’s performance group five to ten percent lower than 
VTAM’S performance group. To see the application program’s performance 
group specification, look at the dispatching priority in the task’s TCB. 


7. If you have not resolved the performance problem, go to “Performance 
Procedure’ on page 62. 
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Chapter 5. «Procedures for VSCS Problems 


vw Documentation You Should Collect for All VSCS Problems 


Always run VSCS with one or more trace options active. The vscs console commu- 
nication services (CCS) trace option defaults to ON and shows what is happening 
between vSCcs and ccs without significantly impacting system performance. (In 
VTAM V3R1.2 and V3R2, the VSCS VTAM trace option also defaults to ON.) When you 
need to re-create the problem, turn on all of the vscs trace options for the failing 
logical unit (LU), or for all logical units if the problem is not related to a specific 
logical unit. To prevent the trace table from wrapping, run traces externally or 
increase the size of the vscs internal trace table. For more information on setting 
the size of the trace table, see VITAM /nstallation and Resource Definition. 


When getting a vScs dump, use the dump formatting routine because control blocks 
are easier to locate in formatted output. 


When you report a problem. be prepared to provide the IBM Support Center with 
the following information: 


¢ vscs link map 
¢ vscs maintenance list 
* vSCS DTIUSER specifications (unless default parameters are used) 


¢ vM directory entries for VTAM and VSCs (if VSCS is run In a Separate virtual 
machine) 


¢ cP user-specified information in DMKRIO, DMKSYS, and DMKSNT (particularly for 
installation and performance problems) 


* GCS user-specific information (particularly for installation and performance 
problems) 


¢ VTAM user-created logmode tables (particularly for logon and incorrect output 
problems). 


Note: If vscs dumps are enabled, and any vScs dumps were created prior to the 
problem you are reporting, please have those dumps available. 


“VM General Procedures to Diagnose Logical Unit Hang Problems” on page 94 

and “vM Determining Device Characteristics” on page 97 explain how you can use 
the VSCS DISPLAY ID Iuname command to determine the status of a particular logical 
unit. In some cases you can also determine where the problem is most likely to 
be, or which products are involved. This can help you determine the type of doc- 
umentation the 18m Support Center will require. 


“VM VM/SP Logo Problems on an SNA Device” on page 113 is another new diag- 
nostic procedure, introduced in v3R1.2. 
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vw General Procedures to Diagnose Logical Unit Hang Problems 


lf the problem is for one or more logical units, but not for all logical units, use the 
following commands to determine additional information as to where the problem 
is, from an external viewpoint: 


94 VTAM Diagnosis 


1. Issue a VSCS DISPLAY ID= luname command. Use the display output to follow the 
steps below. 


a. 


Has vSCS issued a VTAM CLSDST on the logical unit? If so, then the logical 
unit was not found. 


Is message DTIS61! displayed? If so, is this a “DIALED” logical unit? 


Is message DTIS66! displayed? If so: 


Note the current Presentation Services (PS) state of the logical unit. 


If the current state is one of the following—CiP, CLP, IIP, INVL, LGF, LIP, LUP, 
PRG, or SVR—then the logical unit is in an internal state and is waiting 
for another process to complete before continuing processing for this 
logical unit. 


If the current state is AWL, VSCS is waiting for an interrupt from the 
logical unit before displaying the vmw/sP Jogo. 


If the current state is FSs (full-screen support mode), then the applica- 
tion is responsible for restoring the keyboard, not vscs. If the applica- 
tion does not restore the keyboard, SNA logical units are left in a hang 
condition and cannot be reset. 


Determine which response mode is active for this logical unit. 
— Exception response mode (ER; VTAM V3R1.2 and later) 
— Definite response mode (DR; VTAM V3A1.2 and later) 


Note: ER/DR refers to the mode that is allowed for this logical unit, not 
the mode requested for the current operation. 


See the explanations of DTIGEN options in VTAM Installation and 
Resource Definition and VTAM Customization for more information on 
exception response mode. 


Determine whether recovery is in progress for this logical unit. 


SciP indicates that a network failure occurred and that VSCS Is 
attempting to reacquire the logical unit. 


RP indicates that recovery is pending. vscs is waiting for a response 
before initiating recovery for the logical unit (exception response mode 
only). 


RIP indicates that recovery is in progress; vSCs is attempting to recover 
the logical unit (exception response mode only). 


Determine the current VTAM Services (vs) state of the DEVICE. 


lf the current state is TERM, then vSCs is attempting to terminate the 
logical unit. 


If the current state is NORM, then the logical unit has not been termi- 
nated. 
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d. Is message oTIS65! displayed? If so: 
¢ Does this message contain any IUCV PATHIDS? 
If so, then a cp connection is currently active. 


If this message just contains blanks, then a cp connection is not cur- 
rently active. 


¢ What is the current RPL command? 
e is the SEND RPL currently busy? (VTAM V3R1.2 and Sater) 


If so, then vscs is waiting for a VTAM command to complete before 
doing anything else on the user’s behalf. Several conditions can cause 
this to occur, including: 


— Missing \/o interrupt 

— Blocked PAB in VTAM 

— Network problem with device or routes to the device 
— slo never issued. 


Issue the VTAM D net,ROUTES TEST= YES to determine if the route is intact. 
lf itis intact, you need VTAM BUFFER USE and LINE trace to determine 
whether the device responded to the last request. 


e. Is message DTiss9! displayed? (VTAM V3R1.2 and later) 


Note: This message will only be displayed if the RECEIVE SPECIFIC option is 
active. 


If so, then is the RECEIVE SPECIFIC RPL busy? 


If it is not busy, then vscs cannot receive any input from the logical unit. 
Normally, this occurs only when the device is being returned to vTAM, is 
recovering from an error, or is processing input data for the logical unit. 


if the current Ps state is AWL, then the logical unit is hung, because vscs is 
waiting for an interrupt from the logical unit that will never be received. 


If a vSCs internal error did not occur for this condition, then get a dump of 
the vscs virtual machine before recovering the logical unit by use of the 
VTAM VARY Or VSCS FORCE Command. 


f. Is message oTis6s! displayed? 


If so, then are the SEND Or RECEIVE counts incrementing for the logical unit, 
or are both currently zero? 


If both are zero, you need additional information to determine whether the 
problem is in vSCS or VTAM. For example: 


1) If the problem occurred during logon, determine whether the device 
characteristics are correct for this logical unit. Check message DTIS65I. 
If the current RPL command is OPNDST and the RPL is busy, determine 
why VTAM is not not completing the request. 


2) If scip is included with message pDTisé6!, determine why recovery of the 
logical unit is not completing. 


3) tf the current RPL command in message DTISE5!I is CLSDST, and RPL is 
busy, determine why VTaAM is not completing the request. 
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2. Issue a CP QUERY NAMES to See if the logical unit name is still connected to the 
user ID. 


3. If the user is still connected to cp, and the current Ps state in message DTisé66i is 
not FSs, dump the vscs virtual machine. Send a message to the hung user and 


see if that releases the logical unit. 
4, Issue a VSCS QUERY to determine: 
¢ The current vscs trace options that are active 


¢ The buffer status (LIFO or FIFO queuing). 


Note: If the logical unit has been hung for a while, the internal trace table has 
wrapped, unless the trace was running externally, or was running for only the 
logical unit in question. 
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vu Determining Device Characteristics 


To determine if the right vrAmM logmode entry was used, issue the VSCS DISPLAY 
iD=luname command. The resulting messages will indicate how the device char- 
acteristics appear to vSCS. 


1. Is message DTIS61! displayed? 
If so, note the device type: 3277, 3278, 3767, 2741, TWx, or PRT. 


Specifying the wrong vTAM logmode entry, or using the vTAm default logmode 
entry, leads to incorrect operation of the logical unit. In some cases, message 
DTIS99I from DTIPIPUT will occur when input is received from the logical unit. 


Also note the device model. This determines the screen size that is used for 
display devices. (Screen size is displayed in message DTIS631.) 


2. Is message DTISs62! displayed? 
If so, what is the logical unit type? 
0 Non-sna display or printer device 
1  Keyboard/printer device 
2 SNA display or printer device 
3 SNA printer device. 
What are the device characteristics? 


¢ EDS indicates that extended data stream commands are supported (for 
example, use of the Write Structured Field commands). 


¢ NEDS indicates that extended data stream commands are not supported. 
* APL indicates whether the device uses the NEW or OLD APL Character set. 
* COLOR indicates whether the device supports color. 
® SHARED indicates that the device is a shared printer. 
3. IS message DTIS63! displayed? 
Note: This message is issued for displays only. 
If so, note the screen size from the PSERVIC field of the vTAM logmode. 


Also note the alternate screen size from the PSERVIC field of the vTAM logmode 
(or, for some devices, from the Write Structured Field Query reply data). 


4. Is message OTIS64! displayed? 


Note: This message is issued for keyboard/printers only. 
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vu Symptoms of VSCS Problems 
This chapter divides vscs problems into the following general problem types. 


Note: Documentation requirements may differ if vscs is running in a separate 
virtual machine from VTAM. It is also important to understand that vScs errors do 
not always result in a message, user disconnection, or user logoff. 


1. “VMInitialization Problems” on page 101 


e Initialization never completes 

e vscs terminates immediately upon starting 
¢ A loop occurs during initialization 

¢ Other initialization problems. 


2. “VMTermination Problems” on page 109 


e Termination never completes 

e vscs terminates prematurely 

¢ User's session terminates prematurely 

e Operator commands terminate vscs unexpectedly 
e Other termination problems. 


3. “VYMLogon Problems” on page 115 


¢ First logon attempt fails 
e Logon never completes (logical unit is hung). 


4. “VMLogoff and Disconnect Problems” on page 117 
5. “VM Wait and Loop Problems” on page 118 


e All vscs logical units are hung 
¢ One or more VSCs logical units are hung. 


6. “VMMessage Problems” on page 135 

e Message DTISgg! indicates an internal error. 
7. “VMIncorrect Output Problems” on page 138 
8. “YM Performance Problems” on page 143 


e¢ Paging and storage problems 
e Slow response time on terminals. 


9. “VMOther VSCS Problems” on page 144 


¢ SNA dial problems 
e Printer sharing problems 
¢ Operator command is not processed properly. 
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vw Overview of Normal VSCS Initialization Process 


Below is an overview of what takes place during normal VSsCs initialization. This is 


the procedure that vscs follows each time it is initialized. Figure 20 shows the 


components involved in initialization. 


GCS processes IuCcV requests from vscs that affect path iD setup and breakdown. 


lucV external interrupts are handled by Gcs, which gives control to vscs after some 
validation is done. All other lucv requests and responses issued by vSCcs are 
handled directly by cp. 


VSCS and VIAM 


Figure 20. ym Components Involved in VSCS Initialization 


10. 
11. 


. vScs storage is initialized with DTIUSERx, if specified. 


vscs issues message DTICO1I. 
VSCS issues IUCVINI SET to GCS. 

¢ «GCs sets return code after processing request. 
VSCS issues IUCV QUERY to CP. 


¢ cP responds with MAXCONN and EIB size. 


. If vScs trace is active. message DTIS74I is issued. 


vscs issues global IUCVCOM CONNECT and if successful: 


¢ cP provides path ID and a return code back to GCs 

¢ GCS passes path ID and a return code back to vscs 

¢ vscs issues a system WAIT at this point 

¢ cP generates an external interrupt for “CONNECT COMPLETE” 
¢ GCS passes “CONNECT COMPLETE” back to vSCs 

e cP generates an external interrupt for vM/sP logos 

¢ Gcs notifies vscs of a pending message. 


VSCS iSSUeS IUCV RECEIVE 


e vSCS processes “CONNECT COMPLETE 
e jucv should be functional. 
¢ cP sends vM logo data to VSCS. 


VSCS processes VM logo information. 


. VSCS issues Message DTICO2I. 


vSCs attaches VTAM Services and Utility Services subtasks to GCs. 


VSCS iSSU@S VTAM OPEN ACB through GCS to VTAM. 
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12. 


13. 


14. 
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vscs schedules a work element containing the VTAM user iD to Presentation Ser- 
vices. 


VSCS issues Message DTIVO4I. 
* vTAM interface should be functional; vscs is fully functional. 


VSCS isSueS aN IUCV SEND to supply cP with the vTAm user ID. 
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vm Initialization Problems 
First you should look for initialization problems in these areas: 
1. A storage shortage could occur if: 
* vscs is in the same virtual machine as VTAM in a large environment 
* vscs is in a small virtual machine 
¢ vSCS DTIGEN parameters are incorrect 


— Trace table (too large for virtual machine size) 
— Printer table (too large for virtual machine size). 


® MAXCONN in the vm/SsP directory entry for the VSCS user ID. 


2. Misspelled or missing parameters: vscs initialization uses most of the user 
parameters coded for: 


° cP 

° «acs 

¢ VTAM APPL definition 

® DTIUSERX (if specified) 

e vm directory entry for the vscs virtual machine. 


3. Linking to the wrong disk for the vscs load module. 


4. The disk containing the vscs load module has changed since it was last 
accessed by this virtual machine. 


5. The vTAM application program major node is inactive or invalid. 

6. The wrong level of vTAM is specified. 

7. The vm directory is incorrect (the user ID for the tucv option card must be 

"EGGS 2 

If none of the previous items is causing the problem, follow the procedure for your 
symptom: 

¢ Initialization never completes (a wait follows message DTICO1! or DT!S741). 

¢ vscs terminates immediately upon starting. 

¢ A loop occurs (using 90 to 100% of cpu time). 


e Other initialization problems occur. 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 Chapter 5. vm Procedures for VSCS Problems 101 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


vm Initialization Never Completes (A Wait Follows Message DTIC01l) 


102  VTAM Diagnosis 


1. IS SNA enabled? 


A delay during initialization is normal; vScs must wait for external interrupts for 
“CONNECT COMPLETE’ and the vuw/sP logo. A long wait indicates a problem. 
ENABLE SNA is used to open a path from lucy to ccs, and if SNA is disabled, then 
ccs will never process the connection request. 


Note: If SNA is disabled and vscs started, it may appear that most operator 
commands do not complete. 


To make sure that SNA has been enabled, use one of these cP commands: 
#CP ENABLE SNA 
#CP ENABLE ALL 


#CP ENABLE SNA user ID 


For more information on the ENABLE command, see the CP Command Refer- 
ence. 


. Are GCS and the VTAM recovery machine active? 


Issue the GCS command QUERY ETRACE to see if GCS is active. If it is not active, 
you will get the message “UNKNOWN CP/CMS COMMAND.” To activate GCs, use the 
CP IPLGCS command. Use the CP QUERY NAMES Command to see if the VTAM 
recovery machine is active. If it is not active, you need to initialize it. 


. Does Gcs have control register 0 bit 30 on? 


To determine if control register 0 is set on, display the control registers from 
the vscs operator console (DISPLAY X'0') or look in a dump of the vscs virtual 
machine (all registers are shown at the beginning of the dump). Gcs must set 
the control register during GCs initialization in order to receive iucv external 
interrupts from cp. If control register 0 bit 30 is off, verify that the vscs direc- 
tory entry is correct (or the VTAm directory entry, if vScs will run in the same 
virtual machine as VTAM). Continue problem resolution with GCs. 


. Did cP process the IUCV CONNECT request without error? (“Without error” means 


that no error messages were issued by CP, GCS, or VSCS.) 
If so, continue with step 5. If not, the problem is in CP or GCS. 


This is shown in the cp internal trace entries X'15' (lucv) and X'16' (CCS) in the 
cP internal trace table. Before starting vscs, limit the amount of the external 
trace generated by issuing the cP command cPTRAP 15 16. For more informa- 
tion on the cp trace, see the VM/SP Operator's Guide. 


. Did Gcs reflect the external interrupts (for “CONNECT COMPLETE” and the vmM/SP 


logo) to vScs? 

To determine this, look at: 
¢ cP internal trace of luCv and ccs requests 
¢ «Gcs external trace of external interrupts received 
e vscs trace with CCS active. 


(See the VM/SP System Programmer's Guide (for VM/SP R4), or the VM/SP 
Facility for System Programming (for vM/SP R5) for CPTRAP information. See the 
GCS Macro Reference for ETRACE information.) 


If ccs did not reflect the external interrupts to vscs, the problem is in GCs. 
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If all of these conditions are met, the Ilucv will be properly initialized and you 
will see message DTICO2I. 


6. Was VSCS previously active, and now cannot be restarted? 


lf this is the case, the problem may arise from an abend or premature termi- 
nation (message DTICo7!) of vScs during the previous VSCs initialization 
(assuming CP has not been reinitialized since then). If cP and Gcs did not clean 
up after the abend, vScs cannot restart. Check the operator console listing to 
see if any problems were encountered on the previous termination. If there 
were problems, re-IPL GCS. If initialization still fails, re-iPL CP. 


7. If you do not have enough information, or cannot solve the problem, re-create 
the problem with the GCS, CP, and vScs traces active externally. Use your best 
judgment in trying to decide which product has the problem. If you suspect Gcs 
or VSCS is causing the problem, get a vscs dump. Otherwise, pursue the 
problem with cp. (See the CP Command Reference.) 


8. Go to “Reporting Procedure” on page 68. 


vu VSCS Terminates Immediately upon Starting 
1. How far did initialization go? 


Get the operator console listing, and use “yw Overview of Normal VSCS Initial- 
ization Process” on page 99 to evaluate the console messages to see how far 
the initialization progressed. vSCS messages that occur during successful 
initialization are DTICO1I, DTICO2I, and DTIVo4! in this order. 


Note: Messages issued for starting the vscs internal trace are not included 
here. 


If you did not get DTICo1I, the problem may be: 
* GCS is not active 
¢ vscs is not linked correctly 


e The vscs virtual machine is not large enough to hold the DTISTRT load 
module 


e Incorrect DTIGEN parameters. 
¢ GCs is dumping the vscs virtual machine. 
If you got DTICO1 but not DTICo2!, the problem may be: 
¢ vM directory entry for the vscs virtual machine is wrong, or 


¢ cP or GCs found a problem (other than an abend) while processing an Iucv 
request or response. vscs should issue a message to identify the failure 
and reason. See step 2 on page 104. 


¢ GCs is dumping the vSCcs virtual machine. 


If you got DTICO1 and DTICO2!, but not DTIvo4i, the problem may be one of the fol- 
lowing: 


¢ VTAM OPEN ACB error. (VTAM return codes show what caused this.) 
® VTAM APPL definition iS incorrect. 
¢ VTAM APPL definition iS not active. 


¢ VTAM Storage shortage. 
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e vscs storage shortage. 


¢ vSCS DTIUSERX problem, such as incorrect parameters. (See “VM Other 


Initialization Problems” on page 107.) 


¢ Gcs is dumping the vscs virtual machine. 


2. Was an error message issued? 


If so, try to find the source of the message. If not, go to step 5 on page 105. 


CP messages begin with DMk 
GCS messages begin with cs! 
CMS messages begin with OMS 


e vscs messages begin with DTI 


VTAM messages begin with IsT. 


If GCS issued the message, and it is not an abend, get avscs dump. See “VM 
VSCS Dump” on page 155 for more information on the vscs dump. Then go to 
“Reporting Procedure” on page 68. 


3. Did you get an error message with a return code or IPTYPE? 


If so, find the explanation for it, and determine what component issued the 
message. If not, go to step 4 on page 105. 


Figure 21 shows the source of return codes and IPTYPES. 


Message 


DTICxxx 


DTIHxxx 


DTIPxxx 


DTISxxx 


DTIVxxx 


Source of IPTYPE or Return Code 


GCS 
VM 
VSCS (very rarely) 


GCS 
VSCS 


VM 
VSCS (very rarely) 


GCS 
VSCS 


GCS 
VSCS 
VTAM 


Figure 21. VM Source of IPTYPE or Return Code During Initialization 


If you got message DTIcos! with return code 878, then GCS had a GETMAIN 


failure getting storage for an iucv request. See “vM Storage-Related 


Problems” on page 140 for more information. 


If you got message DTICo7! with ipPTYPE =03, the previous termination did not 


complete, or two IUCV CONNECTs with the same name have been issued from 
the same GCS group. IPTYPE=03 is an IUCV SEVER request from cP, indicating 
CP is rejecting the connection request. 
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If you can re-create the problem, follow these steps: 


a. Use the DTIGEN options to activate vscs internal trace options, including 
the external trace option. 


b. Initiate CPTRAP. 

c. Start vscs using the newly created DTIUSERx. 

d. After the failure occurs, stop CPTRAP. 

e. Process the CPTRAP output, which should contain the failing sequence. 


e If you got message DTICosi, you need to determine which component gener- 
ated the return code. See the GCS Macro Reference, the VM/SP System 
Programmer's Guide (for VM/SP R4), or the VM/SP Facility for System Pro- 
gramming (for VM/SP RS) for information on return codes and their 
meanings. 


e If you got a different error message, look in the GCS Macro Reference, the 
VM/SP System Programmer's Guide (for vM/SP R4), or the VM/SP Facility for 
System Programming (for vM/SsP R5) for an explanation of the return code. 


If the message has an IPtyPE, the IPTYPE is one of the following: 


Pending Connection 
Connection Complete 
Severed Connection 
Quiesced Condition 
Resumed Connection 
Incoming Priority Reply 
Incoming Reply 

Incoming Priority Message 
Incoming Message. 


ON OAR DNDN — 


© 


4. Did you get an error message without a return code or IPTYPE? 


if so, does the message text adequately explain the problem? If you can fix the 
problem by correcting user-specified parameters, do so. !f not, get the vm 
directory entry for the vscs virtual machine, vscs installation information, and 
GCS specified parameters. Then go to “Reporting Procedure” on page 68. 


Note: Figure 22 on page 106 shows all the vscs messages that can be issued 
for an initialization problem. 


5. Is the problem an abend? 


if an abend occurs during initialization, the problem is most likely caused by an 
error in the installation process of vscs. Find out how vscs was installed and 
linked. 


An abend (0C2) may also occur if one of the following is true: 
¢ vscs is not running in an authorized virtual machine. 
e The vscs APPL definition does not specify AUTHEXIT= YES. 


lf an abend (706) was received before any vSCS messages are displayed, then 
there was a failure linking the vscs load module. That failure left the load 
module “non-executable.” 


Otherwise, if the failure results from a link failure with a DTIUSERN load module, 
message DTiI11! is issued. 
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If you cannot find and correct the error, get a vScs dump (created automatically 
for an abend) and go to “Reporting Procedure” on page 68. 


6. Is the problem something else? 


If you still cannot identify the problem, get a vscs dump and go to “Reporting 
Procedure’ on page 68. The vsScs dump is described in “vw VSCS Dump” on 
page 155. 


DTICo31 ~=9VSCS INITIALIZATION FAILED--INSUFFICIENT STORAGE AVAILABLE 


Note: The virtual machine is too small to initialize vscs or the DTIGEN parameters are specified 
incorrectly. 


pTico4t ~=VSCS INITIALIZATION FAILED--UNRECOVERABLE ERROR DETECTED 
pticos! VSCS INITIALIZATION FAILED--IUCVINI SET MACRO FAILED WITH RETURN CODE nn 
oTico7| VSCS INITIALIZATION FAILED--GLOBAL CONNECT FAILURE, IPTYPE = nn 
pticot = IUCV GLOBAL CONNECT FAILURE, RETURN CODE = nn 

Note: This message is the result of an error from GCs or CP. 
oTi031 ~=0>DTHTASK COMMUNICATION SERVICES INITIALIZATION FAILED. VSCS TERMINATING. 
DTI041 DTITASK ATTACH FAILED FOR modname VSCS TERMINATING. 
oTiios' 3=- DTIITASK IDENTIFY FAILED FOR modname RETURN CODE = nn 
DTI141 modname ABNORMAL TERMINATION OF VSCS IS IN PROGRESS INITIATED BY modname 
DTIP1s| modname IUCV RECEIVE FAILURE, IUCV RETURN CODE = nn 

Note: cp provides the lucv return code. 
DTIS381 modname VSCS ABEND FOR (PS|VS|US) TASK — SYSTEM COMPLETION CODE = nn 
oTiss9t «= INTERNAL VSCS ERROR — modname n 


Note: If this happens during initialization and you have supplied a DTIUSERx for initialization, it 
may be a DTIUSERX Specification error. 


DTIVO1l modname FAILURE FOR reaqtype RETURN CODE = nnon 


DTIvo6! modname VSCS VTAM SERVICES INITIALIZATION FAILED, SHOWCB MACRO ERROR RTN 
CODES: R15 =nn RO = nn 


OTIvo7!| modname VSCS INITIALIZATION FAILED-OPEN ACB FAILURE, ACBERFLG = nn 


DTIVOsi modname VSCS VTAM SERVICES GENCB MACRO FAILURE FOR controlblkname RTN CODES: 
R15 = nn RO = nn 


Figure 22. ym Messages Indicating VSCS Initialization Problems 
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vm A Loop Occurs During Initialization 
If 90 to 100% of cPu time is being used, and that is not a normal workload for the 
CPU, then the problem could be one of the following: 


¢ GCs is dumping the virtual machine. 


e A VTAM temporary storage shortage has occurred, and VSCs is trying the VTAM 
request again. 


¢ vSCS, VTAM, or GCS may have a control block chained to itself, resulting in an 
infinite loop. 


¢ There is a loop in CCS or IUCV, so that the vscs virtual machine appears to be 
looping, but is not. 


If vscs is running in the same virtual machine as VTAM, it is very difficult to deter- 
mine where VSCs is looping, because of the low priority at which VSCs is running. 
you are using the PER trace to record the loop, the trace must run for at least one 
minute. 


=~ 


If adump message is issued, see “VMVSCS Terminates Immediately upon 
Starting” on page 103 for information on how to proceed. 


1. Determine amount of storage available. 


To determine the amount of VTAM storage available and which storage pools 
need to be enlarged, use either the sms (buffer use) trace or the VTAM DISPLAY 
BFRUSE Command. These service aids are described in Chapter 7, “Using 
VTAM Service Aids.” 


2. If you cannot find any errors from the display of the vTAM buffer pools, collect 
this documentation: 


e A few seconds of the cp virtual machine branch trace (described in the CP 
Command Reference) 


e vscs dump 

e vSCS operator console listing 

e vscs trace with CCS active, running before the loop started 

e vscs trace with any other options active, running before the loop started 


e Series of loop addresses obtained with the CP DISPLAY PSW Command or 
from the cP virtual machine trace output. This command is described in 
the CP Command Reference. 


3. Goto “Reporting Procedure” on page 68. 


vm Other Initialization Problems 
1. Are parameters specified correctly in the OTIGEN macro? 


Figure 23 on page 108 shows messages issued for a problem involving incor- 
rect parameters. 


The parameter value representing the DTIUSER number must be a number in the 
range 0-9, and one byte in length. If you do not get the correct DTIUSERXx 
module in message DTIIO7I, re-access the vSCS LOADLIB and make sure you enter 
this command correctly: 


VSCS START PARM=x (where x is the DTIUSER number) 
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If you are still experiencing problems, have an assembly listing of the DTIGEN 
macro available and go to “Reporting Procedure” on page 68. 


DTI071 USING INITIALIZATION PARAMETERS IN CSECT csectname 
OTII08I INITIALIZATION CSECT csectname NOT FOUND 

DTI091 INVALID INITIALIZATION START PARAMETER 

DTII10! DEFAULT INITIALIZATION PARAMETERS BEING USED 


DTI11 LOAD OF INITIALIZATION CSECT DTIUSERx FAILED, 
LOAD ABEND CODE = yyy, REASON CODE = zzz 


Figure 23. YM vSCS Messages Useful in Analyzing a Parameter Problem 


2. IS VSCS accessing the proper DTIUSERx? 


If you see message DTII10!1, either you did not select the correct DTIUSERx, or the 
loadlib containing the proper DTIUSERx module is not accessible. Issue the cP 
QUERY LOADLIB command and see if the correct loadlib is displayed in the query 
output. If the correct loadlib is not displayed, reissue the CP GLOBAL LOADLIB 
command, specifying the proper loadlib and all of the other loadlibs displayed 
in the query output, then restart vscs again. Make sure the vSCS LOADLIB con- 
tains the DTIUSER you are trying to use. If you have verified that the DTIUSERx is 
correct, and you still have problems, get the portion of the operator console 
listing showing VSCs initialization and a list of the vSCS LOADLIB. 


If you see message DTiI111, then the requested DTIUSERX was found, but an error 
occurred attempting to LOAD it. Check the LOADLIB containing DTIUSERx for 
errors. 


3. Go to “Reporting Procedure” on page 68. 
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vu Lermination Problems 


VSCS issues one of the following messages to indicate termination is in progress: 


OTI113! 


DTIN141 


modname NORMAL TERMINATION OF VSCS HAS BEEN INITIATED BY 
mod2 


modname ABNORMAL TERMINATION OF VSCS IS IN PROGRESS INITI- 
ATED BY mod2 


The 0111141 message is usually followed by a request for a dump. 


If you receive message DTII131, and you did not enter the VSCS HALT or QUIT operator 
command, and VTAM is not terminating, check for previous VSCS or VTAM messages. 
They may indicate why termination is in progress. 


Problems during termination include: 


e “vm Termination Never Completes” 

¢ “vm VSCS Terminates Prematurely” on page 110 

e “vm User's Session Terminates Prematurely” on page 111 

e “vm Operator Commands Terminate VSCS Unexpectedly” on page 112 
e “vm Other Termination Problems” on page 112. 


Choose the symptom most like yours and follow the procedure for that problem. 


vu Termination Never Completes 
1. Was termination initiated by a vscs operator command? 


If so, get a vscs dump and go to “Reporting Procedure” on page 68. If not, 
issue the VSCS HALT command. 


Note: If the vscs Utility Services subtask abended previously, normal termi- 
nation cannot take place, and you must issue the VSCS CANCEL command to ter- 
minate VSCS. 


2. Is vVSCS still in a wait state? 


Display all active sessions with the VTAM DISPLAY LU and VSCS DISPLAY ID =luname 
commands. ISsue a VTAM VARY INACT command for each active session. This 
should allow vscs to continue the termination. If this does not complete termi- 
nation, use the vSCS FORCE ID=luname command. 


3. Is termination still not completing? 


Get the following documentation: 


vscs operator console listing 


vSCS dump (see ‘vm VSCS Dump” on page 155). 


Use the vSCS CANCEL command to terminate VSCS. 


4. Go to “Reporting Procedure” on page 68. 
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v“ VSCS Terminates Prematurely 


110. VTAM Diagnosis 


1. Did message DTIP15I appear? 


This indicates that Presentation Services caused the termination. Get the fol- 
lowing documentation: 


e vscs dumps, if available. (Generated by previous vscs abends or vscs 
internal errors) 


e vscs operator console listing showing any messages that tell which module 
invoked vScs termination. 


e Trace output from any VSCS traces active at the time of vScs termination. 


Go to “Reporting Procedure” on page 68. 


. Did message DTivoil appear? 


If you got this message, issue a VTAM BFRUSE Command and see if the VTAM CRPL 
buffer pool has expanded. If the problem is not caused by buffer expansion, 
get the following documentation: 


¢ VSCSVTAM exit trace, if running at the time of the problem 
¢ A vscs dump. 


Go to “Reporting Procedure” on page 68. 


. Did an ABENDOAS occur? 


This abend code indicates that vTAM terminated while processing under control 
of the VSCS VTAM Services subtask. You must get this documentation: 


¢ vVSCS VTAM exit trace if running at the time of the problem 
¢ The vscs dump created for any previous vSCS abends. 


Go to “Reporting Procedure” on page 68. 


. Did vscs terminate with abend code 878? 


If so, collect the following documentation: 
e The vscs dump created for the abend. 


¢ yvscs global and storage control blocks. Process the vscs dump with 
PRTDUMP, USiNg VSCS dump formatter options 1 and 2. That formats the vscs 
global and storage control blocks. 


e  VTAM storage shortage documentation. 


Go to “Reporting Procedure” on page 68. 


. Did vscs terminate with another abend code? 


lf recovery is possible, a message indicates that recovery is in progress and 
processing will continue. 


lf recovery is not possible, vSCs issues message DTII14! and begins termination. 
Recovery cannot occur for these abend codes: 


OA8 QAI 122 13E 222 322 422 522 
All but 13E and 222 automatically produce a dump. 
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In addition to this dump, get: 
® vSCS trace with CCS active, at the time of the abend 


e vscs operator console listing showing messages around the time of the 
abend. 


Go to “Reporting Procedure’ on page 68. 
6. Is there a storage shortage? 


A storage shortage can cause vSscs to terminate. See “vm Storage-Related 
Problems” on page 140 for more information. 


7. Did any network failures just occur that involve vscs logical units? 


If so, and if sciP recovery is specified for vscs, then both vscs and VTAM require 
additional storage to perform recovery. 


8. Is there a temporary VTAM Storage shortage? 


Use the vTAM SMS (buffer use) trace or the VTAM DISPLAY BFRUSE to determine if 
any VTAM buffer pools are experiencing a shortage. These service aids are 
described in Chapter 7, “Using VTAM Service Aids.” See VIAM 
Customization for information on VTAM buffer specifications. If you cannot 
resolve the problem by adjusting the depleted vTAm buffer pools, go to 
“Reporting Procedure” on page 68. 


9. If you do not know the cause of the termination, collect the following documen- 
tation: 


¢ vscs dump 
e vsCs operator console listing 
¢ Output from any traces active at the time of the problem. 


Go to “Reporting Procedure” on page 68. 


vm User’s Session Terminates Prematurely 
1. Are there any messages on the vscs operator console listing? 


Check the console for vscs messages indicating that the logical unit is being 
terminated, or has just been terminated. These messages may indicate a 
reason for the termination. 


2. Was a VTAM VARY INACT, VSCS FORCE, Or CP FORCE Command issued? If any of 
these operator commands were issued, vSCS responded by terminating the 
logical unit. 


3. Did any errors occur during request processing for this device? If so, get.the 
following documentation: 


e vscs trace running externally with all options active (except FRE and GET, 
for VTAM V3R2) 


¢ VTAM internal trace, OPT=(API,MSG,PIU), MODE = EXT. 


4. Did the termination occur right after a particular command was issued or a 
specific application program was started from a particular device type? If so, 
report the command or application program. 


If you can, re-create the problem with all vscs trace options active, and report 
that information. Otherwise, provide as many details as you can about the 
device you were using, and about the problem. 
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5. If you have not resolved the problem, go to “Reporting Procedure” on page 68. 


Note: Use of exception response mode may increase the frequency of session 
terminations because of limited error recovery, which is considered normal 
operation for VTAM V3R1.2 and later. 


vm Operator Commands Terminate VSCS Unexpectedly 
Do commands other than HALT, CANCEL, or QUIT cause VSCS to terminate? If so, note 
what these commands are. Get the operator console listing and any dumps that 
were produced, and go to “Reporting Procedure” on page 68. 


vm Other Termination Problems 
lf you have a different problem with termination, or you do not know what the 


problem is, get: 
e vscs dump 
e vscs operator console listing 


¢ Output from any vSCs traces that are active. 


Go to “Reporting Procedure” on page 68. 
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vm VM/SP Logo Problems on an SNA Device 


Before looking into potential problems in vscs logo processing, make sure that the 
logo appears correctly on a cp-controlled terminal. 


If you have modified the vm/sP logo, see if the default vu/sp logo works. If it does, 
that indicates that your modified may not be supported on vscs. 
See VTAM Customization for any vscs logo uniqueness. 

1. Logo lines shifted all over the screen and logo is not readable. 


a. Verify that the appropriate VTAM logmode entry for the logical unit was 
used. (Use VSCS DISPLAY ID=luname command.) 


b. If vscs data exit (DTIPDDSO) is coded, verify that the exit is not altering the 
start buffer addresses or the screen attributes in the outbound data stream. 


2. Only the online message is displayed. 


This indicates that both the normal logo and the alternate logo exceeded the 
capacity of the device. 


a. Verify that the appropriate vTAM logmode entry for the logical unit was 
used. (Use VSCS DISPLAY ID=luname command.) 


b. Verify that either the normal or the alternate logo will fit on the screen size 
of the failing logical unit. 


3. Only a single-line logo is displayed. 


For VTAM V3R1.2 and v3R2, this indicates that the normal logo, online message, 
and command lines would not fit on the screen because of the width of each 
line, or because the number of lines allowed was exceeded. 


For VTAM V3A1.1, this indicates that the online message and logo body would not 
fit on the screen. 


a. Verify that either the normal or the alternate logo will fit on the screen size 
of the failing logical unit. 


b. Verify that the appropriate vTAM logmode entry for the logical unit was 
used. (Use VSCS DISPLAY ID=luname command.) 


4. Only the online message and Jogo body are displayed. (VTAM V3R1.1 only) 
Note: You must have vm/SP R5 to get the command line fields. 


a. Verify that the normal logo body plus two lines (online message followed 
by a blank line) and the command lines will fit on the failing logical unit. 


b. Verify that the appropriate VTAM logmode entry for the logical unit was 
used. (Use VSCS DISPLAY ID=luname command.) 


5. Screen colors or highlighting are incorrect or missing. 


a. Verify that the appropriate VTAM logmode entry for the logical unit was 
used. (Use VSCS DISPLAY ID=luname command.) 


b. Check the modified logo to confirm that screen color and highlighting are 
inserted correctly. 


c. If the vscs data exit (DTIPDDSO) is coded, verify that it is not altering the start 
buffer addresses or the screen attributes in the outbound data stream. 
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6. The logo fields are unprotected. 


a. Check the modified logo to confirm that screen color and highlighting are 
inserted correctly. 


b. Ensure that the embedded SET ATTRIBUTE Commands are paired (balanced) 
in the normal logo. 


c. If the vscs data exit (DTIPDDSO) is coded, verify that it is not altering the start 
buffer addresses or the screen attributes in the outbound data stream. 


7. Command line problems. 
Note: Alteration of the command lines is not recommended. 
a. Cursor positioned wrong, or missing. 


The command lines provided by vm contain the Insert Cursor command. If 
this command is missing, then the cursor can be positioned anywhere. 


b. Command lines protected 


1) Ensure that the embedded SET ATTRIBUTE commands are paired (bal- 
anced) in the normal logo. 


2) If the vscs data exit (DTIPDDSO) is coded, verify that it is not altering the 
start buffer addresses or the screen attributes in the outbound data 
stream. 


c. Input from command lines results in incorrect input. 


1) Verify that the appropriate vTAm logmode entry for the logical unit was 
used. (Use VSCS DISPLAY ID=luname command.) 


2) If the vscs data exit (DTIPDDS!) is coded, verify that it is not altering the 
start buffer addresses in the data stream. 


Go to “Reporting Procedure” on page 68. 


If you decide to write your own logo, keep the following points in mind: 


e Changes to the vuw/sp logo are considered to be user modifications. For vscs 
restrictions on altering the vw/sPp logo, see VTAM Customization. 


e For vM/SP R5, user modification of the command lines is not recommended. 


e You cannot use the start buffer address (SBA) or insert cursor (iC) commands 
when you modify the logo body. Other screen commands may not be accepted 
by all types of display devices, and vscs does not offer recovery procedures for 
any i/O errors that may result. 


e The default colors are white for the online message and blue for the logo body 
and input area. If you change the colors, you must start with the online 
message. If you use start field commands to control the colors, you must 
protect the online message and logo body. 
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vw Logon Problems 


1. Issue the VTAM DISPLAY and VSCS DISPLAY ID=luname commands and answer the 
following questions: 


e Does the session exist? 


e lf the session exists, do the device characteristics match the logical unit 
characteristics? 


e lf the RPL is busy, what is the current RPL command? 


See “ym General Procedures to Diagnose Logical Unit Hang Problems” on 
page 94 and “ym Determining Device Characteristics” on page 97 for more 
information. 


2. Are you logging on to vscs for the first time? 


If so, and if you are not using the vTAM-supplied logmode entries, the logmode 
entries are probably incorrect. If you are logging on from an MVS or VSE host, 
that host must provide customized logmode entries. Review the process for 
building your own MODTAB and logmode entries in VTAM Customization (vscs 
requirements in the PSERVIC field). 


3. Are you trying to log on in logo mode? 


When you first turn on the power for your terminal, the vmu/sP logo appears on 
the screen. To log on, press ENTER, the PA1 or PA2 key, and start your input. 


Note: With va/sp R5, command lines are included as part of the logo, which 
allows you to log on directly from the logo screen. 


If you cannot log on in logo mode, try logging on in no-logo mode. If the 
problem still exists, you are probably using the wrong logmode entry. (See 
“vm Determining Device Characteristics" on page 97.) 


If the problem goes away, a user-designed logo may be causing the problem. 
(See “ya VM/SP Logo Problems on an SNA Device” on page 113.) 


To pursue the problem further, collect the following documentation: 


* vscs trace for the failing logical unit with all options active (except FRE and 
GET, for VTAM V3R2) 


¢ VTAM internal trace, OPT=API 

° vTAM buffer contents trace for the failing logical unit 

¢ Output from the VSCS DISPLAY ID = |uname command, if possible 
e Description of what is on the screen 

e The vscs console log. 


4. Did you get message DTIP141 with a return code indicating that the 1ucv global 
path is severed? 


If so, go to page 120. 


If not, issue vMExIT. That should return the logical unit to vTam. Then issue the 
VSCS DISPLAY command. If the logical unit is not found, the problem is with cp. 
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5. Is the terminal hung? 
e If so, was the vu/sP logo removed from the screen? 
— lf so, the documentation you need is: 


— vscs trace for the failing logical unit with all options active (except 
FRE and GET, for VTAM V3R2) 


— VTAM internal trace, OPT =API 
— VTAM buffer contents trace for the failing logical unit 
— The vscs console log. 

— If not, go to step 3. 


e If not, is the vM/SP logo Or VTAM USSMSG10 on the screen? 
— Ifso, the documentation you need is: 


— vscs trace for the failing logical unit with all options active (except 
FRE and GET, for VTAM V3R2) 


— VTAM internal trace, OPT= API 
— VTAM buffer contents trace for the failing logical unit 
— The vscs console log. 
— If not, go to step 6. 
6. Get other documentation. 


In addition to any documentation you have collected so far, get the vScs Ccs 
and VTAM exit trace for the failing logical unit. 


7. Are all terminals hung? 


If so, go to “ vMAII VSCS Logical Units Are Hung (Affects Logons and Current 
Sessions)” on page 119. 


8. Goto “Reporting Procedure” on page 68. 
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vm Logoff and Disconnect Problems 
If the terminal is hung, go to page 129. 


1. Record the status of the terminal. For example, on a display screen, note what 
is in the status area, the last input or the last output to the logical unit. 


2. Issue the CP QUERY NAMES Command and note whether the logical unit name is 
known to CP. 


3. Issue the VTAM DISPLAY and VSCS DISPLAY ID = luname commands and note the fol- 
lowing: 


e Whether the session exists 
e The current RPL command 
¢ Whether the RPL is busy (for VTAM V3R1.2 and later). 


See “vM General Procedures to Diagnose Logical Unit Hang Problems” on 
page 94 for more information. 


4. Collect more documentation: 
¢ Device type, model, and current state (use VSCS DISPLAY ID =luname) 
e CCS and VTAM trace output 
e Any other vscs trace output available 
e vscs dump. 
Note: The vscs dump formatter will print a single logical unit on request. 
5. Find the logical unit control blocks in the vscs dump and look at the following: 


a. The current state of each logical unit. It will be PLB LBCSTATE or VLB 
LBCSTATE. VITAM Data Areas describes these states in more detail. 


b. What is the status of the SEND RPL? Note whether it is busy, and note 
whether it contains any errors. 


c. Note whether the logical unit has any work to process. This is indicated by 
the existence of OTIWEBs in the dump. 


6. After collecting all documentation, go to “Reporting Procedure” on page 68. 
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vu Wait and Loop Problems 


Complete the preliminary procedure below, and if the problem persists, choose the 
symptom that most closely matches yours. Follow the procedure given for your 
symptom. 


¢ “vem All VSCS Logical Units Are Hung (Affects Logons and Current Sessions)” 
on page 119 


¢ “va One or More Logical Units Hung” on page 123 
¢ “vm VSCS Operator Commands Do Not Complete” on page 134. 


Note: The term “hung terminal” means the user is prevented by the system from 
entering data. 


vw Preliminary Procedure for Problems Involving All Logical Units 


118  VTAM Diagnosis 


This is a fairly short procedure that can help you isolate some common reasons 
that cause all logical units to hang. 


1. Is vscs dispatchable? 
Use the following commands to see if VSCS can process anything: 
e Does VSCS respond to the vSCS QUERY command? 
¢ Does ‘vsm’ show up when the CP QUERY NAMES Command is issued? 
¢ Does VTAM respond to the VTAM DISPLAY commands? 


If the answer to all three questions is yes, vSCS is dispatchable and the global 
lUCV connection is intact. Continue with step 2. 


If one or more answers is no, the problem could be one of the following: 
e A higher-priority task is looping 
¢ vSCS is looping 
¢ vscs (or GCS) is waiting for an iucv instruction to complete. 


If the loop or wait occurs during initialization, go to “yy Initialization Problems” 
on page 101. 


If the problem occurs during termination, go to “yw Termination Problems” on 
page 109. 


If the problem occurs during logon, go to “yyy Logon Problems” on page 115. 


If the problem occurs during logoff, go to “yxy Logoff and Disconnect Problems” 
on page 117. Get a vScsS dump (see step 3), and go to “Reporting Procedure” 
on page 68. 


Note: If a vscs dump is in progress, it will appear that all users are hung and 
no console commands will complete. When the dump has completed, proc- 
essing will resume. 


2. Look at operator console output. 


The vSCcs, VTAM, and cP console listings may contain messages that explain 
your present condition. Check for vscs or vTAM messages that indicate that a 
network failure occurred and error recovery is in progress. For example, 
message DTIS31!1 might tell you that vscs is taking a dump. 
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3. 


Get a vSCS dump and a VSCS internal trace. 


lf a dump is not in progress and the vscs console does not respond to com- 
mands issued in “running” status, use the CP DUMP Command in CP mode. For 
more information on the vscs dump, see yyw VSCS Dump” on page 155. For 
more information on CP operator commands, see the CP Command Reference. 
Get the vscs internal trace before recovering the logical unit if possible. 


. Examine the logical unit control blocks and trace output. 


In the dump, find the logical unit control blocks TAB, PLB, and VLB. The vscs 
internal trace, used along with information from the control blocks, may show 
the reason for the hang. 


Note: The VTAM VARY INACT, VSCS FORCE, and CP FORCE commands turn bits on 
and off in the PLB and VLB. Those bits are used to determine the reason fora 
hung logical unit. Therefore, attempt to gather documentation before using 
those commands, unless you suspect one of them is the cause of the problem. 


. Is it a network problem? 


A network problem, such as VTAM failing to terminate a session successfully, or 
outstanding 1/0, may cause logical units to hang. To diagnose VTAM problems, 
see Chapter 3, “Procedures for Specific Problem Types.” 


Note: Before determining that the problem is a vSCs problem, issue the vscs 
DISPLAY 1D =luname to determine whether I/O is active (RPL is busy; VTAM V3R1.2 
and later). 


vu All VSCS Logical Units Are Hung (Affects Logons and Current Sessions) 


If all vscs logical units are hung, the problem is likely to be in one of the following 


four areas: 
Problem Symptoms 
Global |UCV path severed e VSCS issues great quantities of DT] messages 
e Users cannot log on (DTIV121I) 
e Message DTIP14l. 
VTAM Services task e Wait 
problem e VTAM Services save areas show that a VTAM 
request is being processed. 
Presentation Services ina e Loop symptoms 
large enabled loop — Response time is slower than normal 
— 90 to 100% of CPU time is used 
— VSCS console does not respond 
e All VIT entries are the same. 
No VTAM RECEIVE ANY ¢ Message DTIVOSI 
RPLs active ¢ VSCS dump shows inactive RPLs. 


It can be difficult to determine whether vscs is the cause of a loop. The loop can be 
caused by one of the following: 


VTAM Is recovering from a network failure (if VSCS is in the same virtual 
machine as VTAM). 


VSCS iS in SCIP recovery after a network failure. 
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GCs is dumping the virtual machine. 


A VTAM temporary storage shortage has occurred, and VSCS is trying the VTAM 
request again. 


VSCS, VTAM, Or GCS may have a control block chained to itself, resulting in an 
infinite loop. 


There is a loop in CCS or IUCV, so that the vscs virtual machine appears to be 
looping, but is not. 


Note: Check the vscs console log to see if error recovery is in progress. 


Choose the problem most like yours and follow the procedure for it. 


vM Global IUCV Path is Severed 


1. Determine whether the iucv path is severed. 


a. Issue CP QUERY NAMES. If you do not see a “vsm" followed by names, then 
the global path is probably severed. Go to step 2. 


b. vScs issues many DTIXxxx messages because all attempts to communicate 
with cp are rejected. Look at the IPTYPE or return codes in these messages 
(a list of IPTYPES is shown on page 105). If the IiPTYPE or return code indi- 
cates that the Iucv path is not active, or that the path ID is invalid, go to step 
2. VSCS issues message DTIP14i with a reason code indicating why the 
logical unit cannot connect with cp. If the reason code indicates that the 
lucv path is not active, or that the path ID is invalid, go to step 2. 


2. If you have determined that the vscs global path is severed, get data from the 


VSCS CCS trace and any VSCS internal error dumps taken. Get the documenta- 
tion if available, and then go to “Reporting Procedure” on page 68. 


Note: vscs dumps must be enabled at the time of the 1ucv SEVER request to get 
the required documentation. 


vM VTAM Services Task Problems 
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1. Is vSCS in a wait? 


Because vScs uses both synchronous and asynchronous processing, timing 
problems can cause a wait. A wait condition could indicate a problem in the 
VSCS VTAM Services subtask. 


. Is a request presently being processed? 


Find the vTAM Services Save areas and determine if a VTAM request is presently 
being processed. If VTAM does not complete a request, all vscs terminals will 
be hung. 


. If the problem is in VTAM Services, collect the following documentation and go 


to “Reporting Procedure” on page 68: 
e vscs dump 
¢ vSCS operator console listing 
e vSCS CCS and VTAM exit traces active externally 
¢ VTAM internal trace, OPT=(API,MSG,PIU), MODE = EXT 


¢ \VTAM dump (uSe GDUMP Command), unless VSCS is in the same virtual 
machine. 
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vm Presentation Services is in a Large Enabled Loop 
1. Is vScs showing symptoms of a loop? 


These symptoms are typical of a loop problem: 


e Extremely slow response time 
¢ 90 to 100% of cpu time used 
¢ vscs console does not respond. 


2. Do any VSCS trace entries indicate a loop? 


Look at the vscs internal trace table on the screen or in a dump and see if all of 
the trace entries are the same. (See “ymVSCS Trace Facility” on page 159 for 
a description of the vscs trace records). If so, the VSCS CCS trace entries could 
indicate if vScS or CP is Continuously sending |luCV requests or replies. The vscs 
dispatcher trace entries show whether vscs is in an internal loop processing a 
single work element. 


On the screen, use the vSCS QUERY command (see VIAM Operation) to find the 
starting address of the vSCs internal trace table. Then display the address of 
the current entry with the command 


D xxxxxx.20 


where xxxxxx is the current trace entry (the VSCS trace table address +8 is the 
address of the current entry). Record what you see. Wait a minute or two and 
repeat the procedure above. If the vscs trace entries are the same, and only 
the VSCS CCS trace is active, then vscs is in a loop, vSCS is waiting for an event 
to complete, or there is currently no work to process. 


To find the internal trace table in a dump, use the pointer at SABTRHDR in the 
DTISAB. If VSCS is in a loop, the current and preceding trace entries may look 
the same, depending on the trace options that are active. 


3. Find the current logical unit. 


You can find the logical unit being processed by Presentation Services in the 
current (last used) entry in the vscs internal trace table. 


4. Use the dispatcher trace to verify the loop. 


If VSCS is looping on one work element block (DTIWEB), you will see it re- 
dispatched for the same logical unit over and over. For information on the dis- 
patcher trace, see “ym VSCS Trace Facility” on page 159. 


Note: If you limit the number of users on the system at the time of the loop, the 
extent of the loop may be more apparent in the save areas. 


5. Examine the dispatcher work element queue in a VSCS dump. 


The Presentation Services dispatcher work element queue is located in module 
DTISDA1 ina dump. The address of this module in a dump is shown in the vscs 
trace table header and in the link-edit listing. If the queue shows a long chain 
of work to do, vScs may be in a Joop or a permanent wait. If so, the problem 
will be associated with the current user identified by the dispatcher. 


6. Get the following documentation: 
7. If so, the documentation you need is: 


e vscs trace for the failing logical unit with all options active (except FRE and 
GET, for VTAM V3R2) 


¢ VTAM internal trace, OPT =(API,MSG,PIU), MODE = EXT. 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 Chapter 5. ymProcedures for VSCS Problems 121 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


¢ A few seconds of virtual machine branch trace on the vsm, to trace only the 
vSCS address range. 


The beginning of the vscs load module can be found by use of the vscs 
QUERY Command (if VSCS TRACE is active). Message DTIS74i contains the 
starting address of the vscs trace table. Use CP DISPLAY TXXxxx.50 and VTAM 
Data Areas to find the addresses in the THDRSTRT and THDRSDA2 fields. 
Those addresses represent the extent of the vscs load module. 


Note: Use the PER instruction to trace only address ranges of vSCs that you 
want to trace. (For more information on the branch trace, see the CP 
Command Reference.) 


¢ vscs dump 


¢ vscCS operator console listing. 


8. Goto “Reporting Procedure” on page 68. 


vm No VTAM RECEIVE ANY RPLs Active 


122 VTAM Diagnosis 


. Did you get message DT!voS5!? 


VSCS maintains a pool of RECEIVE ANY RPLS, which are used by the receive RPL 
exit to receive data from VTAM for all vScs logical units. vScs monitors the 
number of active RECEIVE ANY RPLS. If none of the RPLS are active, vSCS cannot 
receive data from VTAM. VSCS issues message DTIVOSI for this error condition. If 
you received this message, go to step 3. 


Under certain error conditions, however, the RECEIVE ANY is not issued, and 
VSCS runs Out of RECEIVE ANY RPLS without issuing DTIvo5!. Then vScs cannot 
Communicate with VTAM. 


. Look for the RPL pool in a dump. 


To check for this condition, look for the RPLS in a dump using this method: 
a. Find DTHNSDA1. 
b. Locate the DTIVGB contained in DTIISDA1. 
c. Locate the RECEIVE ANY RPLS. 


DTIVGB + X'18' is the address of the 1st RECEIVE ANY RPL. 
DTIVGB + X'1C' is the address of the 2nd RECEIVE ANY RPL. 
DTIVGB + X'20' is the address of the 3rd RECEIVE ANY RPL. 


Keep adding X'4' to the previous address to find the next RECEIVE ANY RPL. 


The total number of RECEIVE ANY RPLS is Controlled by the DTIGEN parameter 
RPLNUM. The default is 8, but RPLNUM can range from 3 to 16. DTIVGB contains 
the address of each RECEIVE ANY RPL. 


Under normal conditions, all RPLS are active. Check the RPLACTIV field of the 
RPL. If RPLACTIV is X'FF', then the RPL is active. 


If RPLACTIV is not X'FF', then the RPL is temporarily inactive, most likely 
because one of the vTAM Services exits is currently working with it, or VTAM is 
momentarily using it. Check the vSCS VTAM Services save areas to see what is 
being processed. The RPL command code is usually X'23', but it can be X'22' 
or X'24' when used by the RPL exits. The command code is in the RPLREQ field 
of the RPL. 
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3. If RECEIVE ANY RPLS are inactive, get the following documentation: 


® VTAM internal trace, OPT=API.MSG,PIU; active externally 
* VSCS VTAM exit trace 

e vscs dump 

e vscs operator console listing. 


4. Goto “Reporting Procedure” on page 68. 


vm One or More Logical Units Hung 
lf a single terminal is hung, follow these steps: 


1. Use the “VM General Procedures to Diagnose Logical Unit Hang Problems” on 
page 94. 


2. Get the required documentation from “VM Determine When the Hang 
Occurred.” 


3. Try to clear the hang. 
¢ For local non-SNA vscs terminals, press the RESET key. 
e For remote vscs terminals, do one of the following: 

1. Turn the power off, then on. 

2. Use the TEST ON/OFF switch. 


3. For SNA logical units, press the ALT and SYS REQ keys, then enter LOGOFF to 
VTAM. 


4. Press the ATTN key. 


5. Have the operator issue one or more of the following commands from the 
VM Or VTAM console: 


— VTAM VARY INACT,F,ID=luname 
— VTAM VARY INACT,I,|ID=luname 
— VSCS FORCE ID=luname 

— CP FORCE userid 


vM Determine When the Hang Occurred 
Choose from the following list the description that most closely matches your situ- 
ation, and go to that procedure. 


Logical unit hangs while using a full-screen application program, such as 
SPF Or XEDIT (See page 124). 


Logical unit hangs while using console mode or CMS mode (see page 126). 


Logical unit hangs while moving between full-screen mode and console or 
CMS mode (see page 128). 


This may be indicated by a message (see page 129). 


Logical unit hangs after message DTIC10!1 because the path is already 


4 | Logical unit hangs after error condition during purge, logoff, or cleanup. 
severed (see page 131). 


Logical unit remains hung after using VTAM VARY INACT, VSCS FORCE, Or CP 
FORCE commands (see page 132). 


Other (see page 133). 
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1] Logical Unit Hangs While You Are Using Full-Screen Mode or the Logical Unit 
Is Dialed 


1. 


Is a full-screen application program (Such as XEDIT or SPF) responsible for the 
failure? 


In full-screen mode, the application program is responsible for formatting the 
screen, unlocking the keyboard, and reading input data. If the application 
program does not handle these functions properly, the device can be hung. 


Indications of this are: 
¢ PROGXXX message 
e Message limit is reached 


¢ Message ‘NOT ACCEPTED’ appears when you press the enter key. 
This indicates that the application issued a WRITE with keyboard restore, but 
did not retry the previous data. 


¢ The keyboard is locked. 


If you have indications of a full-screen application program failure, get a dump 
of the user's virtual machine and go to “Reporting Procedure” on page 68. 


. Is the logmode defined incorrectly? 


Signs of this are: 


e Invalid characters appear on the screen. 
e¢ The colors are wrong. 

e The screen size is wrong. 

e The logical unit is disconnected. 


Use the vScs command DISPLAY ID =luname to see if the device is defined cor- 
rectly. (See “VM Determining Device Characteristics” on page 97 for more 
information.) If the logmode is defined incorrectly, see VTAM Customization 
and correct the logmode definition. 


If logmode is correct, continue with this procedure. 


. Did an OPCHECK occur? 


Signs of this are: 


e The application program ends. 
¢ The output for a color display shows the wrong colors. 
e The logical unit is disconnected. 


If OPCHECK conditions exist, get the vScs ccs trace and VTAM buffer contents 
trace on the failing logical unit for documentation. 


Go to “Reporting Procedure” on page 68. 


. Is the logical unit hung or data lost after a cP message was displayed or input 


was entered? 


While a logical unit is in full-screen state, vscs should display no cP messages 
(except warnings and priority messages) until input is received (at which time 
the full-screen application is notified of input available). 
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If DOTIGEN Option FSREAD=N has been coded, then you can expect loss of data: 
e If the screen is interrupted before input is received from the logical unit 


e lf modified data input is available, cP messages were displayed, and the 
buffer data is requested by the full screen application. 


Note: The full-screen application program is responsible for restoring the key- 
board after input is received. If the keyboard is not restored, the logical unit 
remains hung. 


Get the vScs trace with CCS, DISP, and VTAM active, and a vScS dump. (See “vm 
VSCS Trace Facility” on page 159 and “vm VSCS Dump" on page 155 for more 
information on getting this output.) 


Go to “Reporting Procedure’ on page 68. 
5. Is the logical unit still hung? If so, get this documentation: 
®e vSCS CCS, DISP, and VTAM exit traces for the failing logical unit 
¢ vscs dump 
¢ VTAM SMS (buffer use) trace for the failing logical unit. 


Go to “Reporting Procedure” on page 68. 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 Chapter 5. vm. Procedures for VSCS Problems 125 


126 VTAM Diagnosis 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Logical Unit Hangs While You Are Using Console Mode or cms Mode 


Note: The cms full-screen command puts the logical unit into full-screen state. 


1. 


is the logical unit waiting for the previous command to be displayed again? 
If so, then one of the following occurred: 


¢ The command has not completed and cp did not notify vscs (via command 
completion or timer expiration) to display the input again. 


¢ The command was executed by the full-screen application program and the 
application did not display the information again. 


¢ The input has not been accepted. 


Get a vScs ccs trace for the failing logical unit and avscs dump. Then go to 
“Reporting Procedure” on page 68. 


. Is the logical unit hung after a ‘MORE’, ‘HOLDING’, Or ‘NOT ACCEPTED’ condition? 


If so, get a vscs dump and the vscs ccs and dispatcher traces. Then go to 
“Reporting Procedure” on page 68. 


. Are the vscs data translation exits coded? 


The following vscs user exits affect the logical units’ reaction to any outbound 
data streams and cp’s reaction to inbound data streams: 


DTIPDNTI U1 inbound data 
DTIPDNTO LU1 outbound data 
OTIPDDS! display input data 
DpTIPDDSO =. display outbound data. 


If the problem does not appear to be a problem in the user-coded exit, get the 
following documentation: 


® vSscs CCS trace 
¢ SCS DATA trace (V3R2) 
¢ vTAM buffer contents trace for the failing Lu. 


Go to “Reporting Procedure” on page 68. 


. Is the problem with a 3279 color terminal (type 0 logical unit)? 


Make sure FEATUR2=EDATS is specified in one or more of these ncP definitions: 


LINE 
GROUP 
CLUSTER 
TERMINAL. 
Also, check the coding of the user exits (DTIPDDS!I and DTIPDDSO). 


if color or highlighting still does not work correctly, get the following documen- 
tation: 


e vsSCS CCS and VTAM exit traces, and data for the failing logical unit 
¢ vTAM buffer contents trace for the failing logical unit. 


Go to “Reporting Procedure” on page 68. 
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5. Is the device dialed to another system? 
If so, go to the full-screen procedure on page 124. 


Note: Dialing to Ppvm and passing through to another cms system gives the 
appearance of normal console and cms screens. However, vscs receives the 
entire screen already formatted, including the status area, and processes the 
data as full-screen data. 


6. Documentation for problems not described above: 
If you can re-create the problem, get: 


e vscs trace for the failing logical unit with all options active (except FRE and 
GET, for VTAM V3R2) 


e vscs dump 
© VTAM internal trace with OPT =(API,MSG,PIU,PSS,SSCP), MODE = EXT 
¢ vTAM buffer contents trace for failing logical unit. 
If you cannot re-create the problem, get: 
¢ vScs trace with CCS active, for just the failing logical unit, if possible 
e vscs dump 
¢ VTAM logmode being used. 


Go to “Reporting Procedure” on page 68. 
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Logical Unit Hangs When You Switch Medes 
1. Does your terminal hang when you switch between modes? For example: 


¢ Console mode to CMS mode 

¢ CMS mode to console mode 

¢ cms or console mode to full-screen mode 
e Full-screen mode to Cms or console mode. 


2. If so, get the following documentation: 

If you can re-create the problem, get: 
e vscs dump 
¢ vTAM buffer contents trace 
¢ vscs ccs and dispatcher traces with just the failing logical unit traced 
© VTAM internal trace with OPT=(API,MSG,PIU,PSS,SSCP), MODE = EXT. 

lf you cannot re-create the problem, get at least: 
¢ vscs dump 
¢ vscs trace with ccs and DISsP active. 


3. Go to “Reporting Procedure” on page 68. 
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4 Logical Unit Hangs During Logoff or Disconnect Processing 
1. Have any messages been issued? 

Get the operator console log and look for messages that pertain to the hang. 
2. Determine the component that sent the message. 


lf the message has a return code, use Figure 24 to determine the component 
that may have sent the message. Then look in VITAM Messages and Codes to 
see what the return code means. 


If the message has no return code, use the message prefix to determine where 
the message is coming from. Page 104 has a list of the message prefixes for 
each component. 


Message Source of Return Codes 
DTIPxxx GCS 
VM 
VSCS 
DTISxxx VM 
VSCS 
DTIVxxx VTAM 


Figure 24. VMSource of Return Codes 


3. Are other components connected to the logical unit? 


Answering these questions may indicate which components are still communi- 
cating with the logical unit. 


e Does the vScs command DISPLAY ID=luname show the status of the device? 
(See “VM Determining Device Characteristics” on page 97 for more infor- 
mation.) 


e Is the user still logged on to vM? Try the CP QUERY NAMES Command. If the 
logical unit name and user ID appear, the logical unit is connected to vm 
and the cp lucv connection is intact. If the response is gibberish, the 
logical unit is not connected to vm and the cP Iucv connection has been 
severed. 


¢ Does VTAM show the logical unit still in session with vscs? (Use the VTAM 
DISPLAY command.) 


4. Note the status of the logical unit at this time. For example, on a display 
screen note what is in the status area, and what was the last input or the last 
output to the logical unit. 
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. Collect documentation before recovery. 


If you can re-create the problem, get: 
e vscs dump 
¢ vTAM buffer contents trace 


e vscs trace for the failing logical unit with all options active (except FRE and 
GET, for VTAM V3R2). 


if you cannot re-create the problem, get: 
e vscs dump 


® vscs trace with CCS active. 


. Recover the logical unit with one or more of these commands: 


¢ CP FORCE 
@ VTAM VARY INACT 
© vSCS FORCE. 


. Go to “Reporting Procedure” on page 68. 
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Logical Unit Hangs After Receiving Message pTIc10! 
1. Did these symptoms occur? 


Message OTIC101 indicates that an iucv request or response was received on the 
global path after an iuCv SEVER was issued by vscs. Most of the time this does 
not cause a problem, because cp logs off or disconnects the logical unit when 
the iucv SEVER is processed. If it is a problem, it could produce these symp- 
toms: 


¢ Abend or program check 

e vscs message DTII14I 

¢ Loss of operator communications. 

¢ Message CsiIxT413T indicates that the signal services path was severed. 


2. Collect documentation. 
¢ vscs dump 
e vscs trace with CCS active, running for all logical units. 


3. Go to “Reporting Procedure” on page 68. 
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(@ Logical Unit Stays Hung After You Use vary INACT or FORCE Command 
1. Try both the VTAM VARY INACT and Cp FORCE commands. 


If the logical unit is being terminated by vm, the VMBLOK status prevents the cP 
FORCE command from being effective. The vMKILL bit in the VMBLOK indicates 
whether cp is in the process of terminating the logical unit. If you issue the cp 
FORCE command and the resource is unknown, cP may be waiting for an !ucv 
reply before completing the termination process for the logical unit. Try using 
the VTAM VARY INACT command. 


If the logical unit is still hung, continue with step 2. 
2. Determine which components are still connected to the logical unit. 


e Use the vscs command DISPLAY iD =luname to determine the status of the 
logical unit and of the SEND RPL. 


e is the user still logged on to vm? 


¢ Does the logical unit name appear when you use the CP QUERY NAMES 
command? If so, the vm connection has not been severed. 


¢ Does vTAM show the logical unit still in session with vscs? Use the vTAM 
DISPLAY Command to determine this. 


From this information, try to determine which components are connected to the 
logical unit. 


3. Note the status of the logical unit at this time. For example, on a display 
screen, what is in the status area, and what was the /ast input or the last output 
to the logical unit? 


Note: If the user logged off and the screen says “HOLDING,” you must clear the 
screen before the logical unit can be disconnected from vm. (This is normal for 
VSCS.) 


4. Collect documentation. 
If you can re-create the problem, get: 
« vscs dump 
e vscs operator console listing 
¢ vTAM buffer contents trace 


¢ vscs trace for the failing logical unit, running externally, with all options 
active (except FRE and GET, for VTAM V3R2) 


¢ VTAM internal trace with OPT=(API,MSG,PIU,PSS,SSCP), MODE = EXT. 
if you cannot re-create the problem, get: 

¢ vscs dump 

e vscs operator console listing 

e vscs ccs and dispatcher trace. 


5. Go to “Reporting Procedure” on page 68. 
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Logical Unit is Hung for Other Reasons 


1. Answer these questions. 


a. 


e. 


Issue the CP QUERY NAMES command on the cp console. Does the logical 
unit name appear? 


. Is vscs still controlling the logical unit? (Use the VTAM DISPLAY command to 


discover this.) 


. Have any messages appeared on the VTAM or vSCs operator console for this 


logical unit? 


. What is the last sequence of messages issued? (See the vscs operator 


console listing.) 


Issue VSCS DISPLAY ID=juname. Is the RPL busy? 


2. Collect documentation. 


If you can re-create the problem, get: 


vscs dump 
VSCS operator console listing 
VTAM buffer contents trace 


vscs traces for the failing logical unit, running externally, with all options 
active (except FRE and GET, for VTAM V3R2). 


VTAM internal trace with OPT=(API,MSG,PIU,PSS,SSCP), MODE = EXT. 


lf you cannot re-create the problem, get: 


vscs dump 
vsScs operator console listing 


vscs ccs and dispatcher trace. 


3. Go to “Reporting Procedure” on page 68. 
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vu VSCS Operator Commands Do Not Complete 


1. Has the vscs Utility Services subtask abended? 


Check the operator console listing to see if the Utility Services subtask abnor- 
mally terminated. If this occurs vScs can do no further processing of operator 
commands. Use the vSCS CANCEL command to terminate vscs. Then get the 
dump generated by the abend and go to “vm Termination Problems” on 

page 109. 


2. Does a GCS message indicate a problem with the Gcs console task? If that task 
abended or could not get storage, operator commands cannot reach VSCs. 


3. If the problem is not an abend or GCs console task, try these commands: 


e If vSCS is running in the same virtual machine as VTAM, enter a VTAM 
command such as DISPLAY LU. Does it complete? 


— If yes, vScs may be in a loop or a permanent wait. 
— If no, the problem is in the vTAM virtual machine. Continue down this 
list to determine where the problem is. 


e Enter the CP QUERY TIME Command. This shows whether GCs is processing 
and passing cP commands to cP. 


e Enter #CP QUERY NAMES. This shows whether cP commands are being proc- 
essed. 


4. Does GCS process some commands, but not others? Does the PA1 key put the 
terminal in CP READ mode? 


If the answer to both questions is yes, GCS is looping or waiting for an event to 
complete. In CP READ mode, isSue SET RUN OFF. Then enter the cP command D 
Psw to display the current psw. Display the storage around the address shown 
in the second half of the Psw. If the last instruction issued was X'B2FOxxxx', CP 
has not completed an lucv request, and vscs and the virtual machine are per- 
manently waiting for a response. If the problem does not involve an luCcVv 
instruction, check to see if the wait bit (bit 14) is on in the Psw. If so, the 
problem is in the vscs virtual machine. Get a vScs dump and go to “Reporting 
Procedure” on page 68. The vscs dump is described in “vm VSCS Dump” on 
page 155. 
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vu Message Problems 


For messages other than DTIs99!1, go to “Message Procedure’ on page 53. 


vu Message DTIS99I Indicates a VSCS Internal Error 


Message prTisg9! tells you that a VSCs internal error occurred for module DTIXxxxx 
and a number (n). The number identifies the reason the message was issued. Use 
the lists below to determine which component of vscs issued the message. See the 


following example: 


DTIS99I INTERNAL VSCS ERROR — DTIPRSVR 1 


This indicates that vScs attempted to issue an 1UCv SEVER for the vscs global path. 


For this error, a dump is taken (if dumping is enabled) and the SEVER request is 


ignored. 


1. Presentation Services issues messages with this information: 


Module n Error Description 
DTIPDADV 1 SEND-in-progress bit error (VTAM V3R1.2 and later) 
DTIPICPY | SEND-in-progress bit error (VTAM V3R1.2 and later) 
DTIPIPUT 1 Error in logical aid 

2 Invalid WEBLAID (logical aid) 
DTIPISYN 1 Invalid SEND/REPLY WEB type 
DTIPOCWR 1 SEND-in-progress bit error (VTAM V3R1.2 and later) 
DTIPOFWR 1 SEND-in-progress bit error (VTAM V3R1.2 and later) 
DTIPOVSR 1 SEND-in-progress bit error (VTAM V3R1.2 and later) 
DTIPOWIC 1 SEND-in-progress bit error (VTAM V3R1.2 and later) 
DTIPOWRT 1 SEND-in-progress bit error (VTAM V3R1.2 and later) 
DTIPRACT 1 Received an invalid WEB 
DTIPRSVR 1 Attempting to issue a SEVER for global path ID 
DTIPRWEB 1 Invalid WEB 
DTIPSCFS 1 Invalid FS response WEB 
DTIPSCPY 1 SEND-in-progress bit error (VTAM V3R1.2 and later) 
DTIPSFCR 1 SEND-in-progress bit error (VTAM V3R1.2 and later) 
DTIPSPIN 1 SEND-in-progress bit error (VTAM V3R1.2 and later) 
DTIPSTAM 1 Queue tag error for work element queue 

2 Invalid WEBFUN or WEBMODE 

3 Invalid WEBFUN or LBCSTATE 


Note: DTIPIPUT will request a dump if you use the wrong logmode entry when 
logging on to vscs with a type 1 logical unit (Twx, 2741, or 3767). The PSERVIC 


field in the logmode entry you use must contain X'01' in byte one, or vscs 


assumes the terminal is a type 0 logical unit (display terminal). vScs requires a 
valid aid character to process input from a type 0 logical unit, and the type 1 
logical unit does not provide this. 
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2. VTAM Services issues messages with this information: 


Module 
DTIVCLSX 
DTIVLOFF 
DTIVPURG 
DTIVRECA 
DTIVRECX 


DTIVREJR 
DTIVSEND 


DTIVSNDX 


DTIVSTAM 


DTIVTPNX 


OQhwOM = A Onmnaeaaoawanuiunalsy 


oO) 


ot G RQ = =] 


Error Description 


Schedule request to DTIVTRME failed 

No storage available 

i{UCV connection exists 

Schedule failed 

Error in building WEB 

invalid input chain 

Logical unit not in termination 

invalid request (VTAM V3R1.2 and later) 

Invalid request (VTAM V3R1.2 and later) 

Recovery queue empty during recovery (VTAM V3R1.2 and 
later) 

Schedule request failed (VTAM V3R1.2 and later) 

Invalid RPL response 

Dequeue error in recovery (VTAM V3R1.2 and later) 
Invalid data response in recovery (VTAM V3R1.2 and later) 
Invalid RPL response (VTAM V3R1.2 and later) 

Recovery queue empty during recovery (VTAM V3R1.2 and 
later) 

Recovery queue empty during recovery (VTAM V3R1.2 and 
later) 

Attempting to schedule DTICMT (VTAM V3R1.2 and later) 
Queue tag error for work element queue 

invalid WEBFUN or WEBMODE 

invalid WEBFUN or LBCSTATE 

Cannot schedule request 


3. System Services issues messages with this information: 


Module 


DTISCHED 
DTISDEQU 
DTISENQU 
DTISFREB 


DTISFREM 
DTISGETB 


DTISGMGR 


NmM— —O —| — A = — = = = | g 


Error Description 


Invalid process identifier 

Queue tag does not match tag in queue header 
Invalid chain pointer 

Queue tag does not match tag in queue header 
Invalid SMP tag 

Invalid request (releasing storage that is already free) 
Invalid SMP tag 

Control block error or request is too big to obtain 
Invalid free block count 

PDBUSCNT (chain pointer) is invalid 

Empty POBSDB queue found 
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4. Documentation to collect for vscs internal error problems: 


e Issuer of the message: Presentation Services, vTAM Services, or System 
Services 


e Reason the message was issued 


*¢ vscs dump (produced automatically as a result of message DTIss9l if dumps 
were enabled prior to the problem occurring) 


e vscs operator console listing 


¢ Any vscs traces that were active at the time of the error. 
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vu Incorrect Output Problems 


138  VTAM Diagnosis 


1. 


Describe the incorrect output. The following list shows some of the possible 
symptoms: 


e The size of display screen is incorrect. 
e The status area of the display screen does not work as expected. 
¢ Highlighting or color do not work as expected. 


e Invalid characters appear in the output, such as EBCDIC, APL, TEXT, or double- 
byte Kanji characters. (Invalid characters are any characters that are obvi- 
ously wrong or that you don't expect.) 


¢ Input data is lost. 


¢ PROGXXXxX OCCUrs ON SNA 3270s. If this happens during full-screen mode, the 
contents of the data stream may be invalid. If the terminal is not in full- 
screen mode, this message is more likely to indicate a vscs problem or a 
logmode problem. 


¢ The device does not function like a vM-supported terminal and the problem 
is not due to a known restriction. 


¢ The incorrect output does not involve full-screen data or the vmM/sP logo, 
and one or more of the following symptoms occur: 


— Data is misplaced on the screen. 
— Data is missing. 
— Content of data is incorrect. 


— Device errors occur or the Jogical unit is disconnected when you 
execute a command or a program. 


2. Check to see that product restrictions are not causing the incorrect output. 


3. Does the incorrect output invoive the logo? See “vm VM/SP Logo Problems on 


“I 


an SNA Device” on page 113 for more information. 


Note: If you enter both the user ID and the password on the user ID line, you 
may receive a different DMK message than you would if you entered only the 
uSer ID. 


. Is the device defined correctly to vscs? 


Use the vscs command DISPLAY ID=luname to determine if the device is defined 
correctly to vscs. If the DISPLAY command is not successful, get a dump of VSCs. 
The logical unit control blocks in a dump also show the LU definition. 


If the LU definitions are not correct for the device, correct them and retest the 
logical unit. See VTAM Installation and Resource Definition for more informa- 
tion on defining logical units. 


Check to see if the appropriate vTAM logmode for the device is being used. See 
VTAM Customization for more information on logmodes. 


Are user translation exits involved? 


If your system has user-written translation exits, try to re-create the problem 
without them. Use the DTIGEN parameters and see if the problem still occurs. 


Is Kanji support involved? 
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Double-byte character support for Kanji does limited editing. Check the data 
stream sent to see if it is within the limitations of double-byte support. 


Note: vscs does not check whether the device supports Kanji. The application 
has this responsibility. 


8. Are Twx 3101 configuration switches set up as documented by vm? See the 
VM/SP Terminal Reference to find out how these switches should be set up. 


9. Other possible causes of incorrect output are listed here. You may choose to 
investigate these further. 


e Functional limitation due to the release of vm/sp used 
¢ Hardware problem 

e vscs problem 

e vM problem 

e¢ vM application problem. 


10. If the problem has not been solved, collect the following documentation: 

e For status area problems, lost input, device errors, and disconnections: 
— vscs dispatcher trace of the failing logical unit. 
— VSCS trace with CCS active, of the failing logical unit. 
— VSCSVTAM exit trace of the failing logical unit. 
— VTAM buffer contents trace. 

¢ For all other incorrect output problems: 
— TAM buffer contents trace of the failing logical unit. 
— vscs trace with CCS active, of the failing logical unit. 


— Ifavscs dump is necessary, limit the number of users on the system 
and use the VSCS BFRFIFO command before re-creating the problem. 
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. Storage-Related Problems 


Storage problems in vScs can occur for several reasons; they may indicate a 
problem in vscs. For VTAM v3R2, issue the VSCS STORAGE command whenever you 
suspect that storage is causing problems. 


1. Determine whether the virtual machine in which vscs resides in is large 
enough. Estimate this using NPP Storage Estimates. 


Note: If vscs resides in the same virtual machine as VTAM, add the storage 
requirements for VTAM. 


If the virtual machine is large enough for your environment, continue. Other- 
wise, correct the vSCS virtual machine size. 


2. If you are using new vscs Start parameters, evaluate changes made with DTIGEN 
parameters: 


e Trace table size 

e Increase in the number of printers 

e Receive buffer size 

¢ BLKMULT greater than one 

¢ VSAMLM number increased 

e Transmit buffer sizes for both logical units and displays 
¢ RECEIVE SPECIFIC option (VTAM V3R1.2 and later) 

¢ Exception response option (VTAM V3R1.2 and later). 


If vscs ran properly before these changes, review the size of the vscs virtual 
machine before reporting a problem. 


You can use the VSCS STORAGE command (VTAM V3R2) to see: 
e Current number of VTAM sessions and cP connections 
e Indicator of storage shortage in message DTIS151 
¢ Some of the DTIGEN options that are currently active 
¢ Storage management parameters for VTAM V3R2 that have been specified 
¢ Number of VeiBs allocated (controlled by VSAMLM). 


If vSCS is running in the same virtual machine as VTAM, use the VTAM DISPLAY 
BFRUSE command to determine VTAM’s Storage usage. 


3. Is the network in slow-down or recovery mode? 


If the network is in slow-down mode, it will take additional storage to maintain 
data destined for the logical unit. This symptom could also be caused by one 
of the following: 


® VTAM is recovering from a network failure. 
e vscs is in SciP recovery after a network failure. 


e vscs is in a different virtual machine than vTAM, and a dump is being taken 
for VSCS Or VTAM 


e A VTAM temporary storage shortage has occurred. 


e¢ The vo buffer has expanded for a vTAn-controlled device. 
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4. 


Are several logical units hung? 


The storage being used by hung logical units remains allocated until the 
logical unit is released or is terminated. If you are using the exception 
response mode and RECEIVE SPECIFIC options, the amount of storage used could 
be enough to cause a storage shortage. See “vm General Procedures to Diag- 
nose Logical Unit Hang Problems” on page 94 before continuing. 


lf you can re-create the problem, or if it is occurring frequently, gather the fol- 
lowing documentation: 


e vscs internal trace with options CCS, DISP, FRE, and GET active 
¢ Dump of the vscs virtual machine. 
Did you receive message DTIS99I for DTISFREB Or DTISGETB? 
This indicates that vscs is having a problem managing storage blocks. 


Note: As with other pTis991 problems, dumps must be enabled prior to the error 
or you cannot get proper documentation. 


If you can re-create the problem, or if it is occurring frequently, gather the fol- 
lowing documentation: 


e¢ vScs internal trace with the options CCS, DISP, FRE, and GET active 
¢ Dump created when message DTIS99! is issued. 


Get a vScs dump and go to “Reporting Procedure” on page 68. 


. Did you receive message DTISi0l, followed by oTIv121? 


This sequence of messages indicates that either the virtual machine is too 
small, or all available storage has been depleted. If the vscs virtual machine is 
large enough, the available storage may be allocated to a different vscs 
storage pool than the current storage requester. 


For example, if storage is available in the Presentation Services pool, but VTAM 
Services needs it, then GCS cannot provide additional storage. Logons are 
rejected until Presentation Services releases the storage. 


In VTAM V3R2, you can control the distribution of dynamic storage by coding the 
DTIGEN parameters that allow swapping of storage segments in one pool to a 
different pool, or returning them to Gcs. The default for the DTIGEN storage 
options is to work as previous release of vSCS. 


Get the following documentation: 


e¢ vScCS trace with CCS and DISP active (and FRE and GET, for VTAM V3R2), for all 
logical units, before the problem occurred (externally if possible). 


¢ vscs dump. 


Go to “Reporting Procedure” on page 68. 
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7. Is it an lucvV pacing problem? 


lUCV pacing is controlled by the value specified in the DTIGEN parameters (DPACE 
for displays and KPACE for keyboard/printers). 


For displays, the default value is the screen depth, which is also the default if 
the pace is set to 0. The screen depth varies by display type. 


For keyboard/printers, the default is 10. If the pace is set to 0 for 
keyboard/printers, there is no \Uucv pacing. 


For Twx logical units, the default is 1, and cannot be changed in vscs. That can 
lead to increased lucv traffic, which can lead to a vscs storage shortage in a 
large network, or if vscs is running in a small virtual machine. 


If lucV pacing is not set properly, change the DTIGEN parameter and reinitialize 
vscs with the new DTIGEN. If the problem persists, get the following documenta- 
tion: 


* vscs trace with CCS active, started before the problem occurs 
e vscs dump. 


Go to “Reporting Procedure” on page 68. 


. Other 


If the problem cannot be isolated from previous steps, then a dump of the vscs 
virtual machine is required. After obtaining the dump, use the vscs dump for- 
matter to print the vscs storage control blocks. If vscs is in the same virtual 
machine as vTAM, then also evaluate the vTAM storage. 


Get the output from the vscs formatter and the console log, and go to 
“Reporting Procedure” on page 68. 
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vw Performance Problems 


a3 


Do not use a large value for the DTIGEN parameter VSAMLM. This can lead to 
excessive paging in a medium-to-large environment. See VTAM Customization 
for more information on VSAMLM, and NPP Storage Estimates to see if the 
virtual machine size is correct. 


Note: If vScs is running in the same virtual machine as vTaAM, include the VTAM 
storage size required when you determine the virtual machine size. 


If you think your performance problem is related to paging and storage, (for 
example, you are getting slow response time for operator commands or logical 
units,) collect this documentation: 


e vscs dump 
¢ OTIGEN parameters 


e GCs internal trace for GETMAIN and FREEMAIN. 


. If you think your performance problem is related to logical units, (for example, 


you are getting slow response time for I/O operations,) collect this documenta- 
tion: 


¢ VTAM I/O trace 
¢ VTAM buffer contents trace 


¢ vscs trace for the failing logical unit, running externally, with all options 
active (except FRE and GET, for VTAM V3R2) 


e «cs internal trace for SiO and I/o. 


. If you do not know the cause of the performance problem, collect all of the doc- 


umentation in the two lists above, plus supply the values for MAXBFRU, UNITSZ, 
and |OBUF. 


. When you have collected the necessary documentation, go to “Reporting 


Procedure” on page 68. 
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vm Other VSCS Problems 


Miscellaneous topics are covered in this section: 


¢ “vm SNA Dial Problems” on this page 
e “vm Printer Sharing Problems” on page 146 
¢ “vm Operator Commands Are Rejected” on page 147. 


vu SNA Dial Problems 


SNA dial keeps the logical unit in full-screen state from the time the dial is complete 
until the dial is dropped or reset. All of the information on the screen is supplied 
by the resource that was dialed. 


1. If the screen size changed after one of the following occurred, take the indi- 
cated action: 


a. A VTAM logical unit dialed another virtual machine. 


Make sure the virtual machine you are dialing supports the features pro- 
vided by your logical unit. 


b. A VTAM logical unit, dialing Ppvm, dialed another Gcs group or host con- 
taining VTAM. 


When dialing pvM, the logical unit is defined as a logical address, which 
may prevent the real device characteristics from being known. If you are 
dialing another vTAM machine, supply a logmode name that describes the 
type of terminal you are using. 


If the screen size is still incorrect, collect the following documentation: 
¢ vScs trace with CCS active 
e vscs dump 


¢ vTAM buffer contents trace (in both hosts if connecting to another VTAM 
machine). 


2. Is the logical unit hung? 


If you are using PvM, find out whether the resource you are attempting to dial is 
active. An inactive resource could result in a hung logical unit. If the resource 
is active and the logical unit is hung, the resource, PVM, VSCS, CP, or GCS may be 
experiencing problems. Note whether other pvM users’ terminals are also 
hung. 


If you cannot determine the reason, get the following documentation: 
¢ vscs dump 
¢ vscs trace with Ccs active (must be active before the hang occurs). 


In the vscs dump, find the logical unit control blocks and the last few trace 
entries for that specific logical unit. From this, answer the following questions: 


a. Is the PLB LBCSTATE of the logical unit 20, 40 or 60? 
b. Is the SEND RPL busy, indicating vscs is waiting for a response? 
c. Did vscs respond to all outstanding requests? 
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If everything is specified correctly, then get the following documentation: 
¢ vscs dispatcher and vTaM exit traces 
¢ VTAM internal trace, OPT= API 
¢ vscs dump. 
Go to “Reporting Procedure” on page 68. 
3. Is the vo interrupt missing? 


if the situation is caused by missing I/o, run these traces externally on just the 
failing logical unit: 


* vSCS CCS and VTAM exit traces 

¢ vTAM internal trace, OPT=CIO, MODE=EXT 

¢ cCPSIOSIOF, and I/O traces (See the CP Command Reference) 

* GCS SIO and I/o traces (See the VM/SP Planning Guide and Reference). 


Go to “Reporting Procedure” on page 68. 
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vm Printer Sharing Problems 
1. Is vscs printer sharing failing? 


If you coded a DTIGEN macro with PRTSHR=N, then change to PRTSHR=Y, reas- 
semble DTIUSER, link DTIUSER into the VSCS LOADLIB, and reinitialize vScs with the 
correct DTIUSER number. 


If you are using default parameters or you are using a OTIUSER With PRTSHR=Y 
coded, then get the following documentation; 


¢ vscs dispatcher and VTAM exit traces 
e vscs dump. 


Go to “Reporting Procedure” on page 68. 
2. Does VTAM SIMLOGON fail after you use the VSCS PRINTER Command? 
If the VTAM SIMLOGON fails, then make sure: 
¢ The printer name was spelled correctly 
e The resource is known and available to VTAM (use VTAM DISPLAY command) 
e The vTAM logmode for the printer logical unit is correct. 
3. Does ‘NOT AVAILABLE’ appear in the status area of the display? 


In order for vSCS to access a VTAM printer, either the VSCS PRINTER Command or 
a VTAM VARY ACT command must be issued first. See VTAM Operation for more 
information on commands. 


If the proper command was not issued or the printer name was misspelled, 
issue the command again with the correct name. 


If the proper command was issued to identify the printer to vscs, get the fol- 
lowing documentation: 


¢ vscs dispatcher and VTAM exit traces 
¢ VTAM internal trace, OPT=API 
¢ VTAM buffer contents trace for the printer logical unit 
¢ vscs dump. 
Go to “Reporting Procedure” on page 68. 
4. Is vscs not releasing a printer when requested to? 


lf the printer was allocated to vscs by using the VTAM VARY ACT,LOGON=VSCS 
command, then a VTAM VARY INACT command is the only way to release it. 


If the VTAM SIMLOGON was used (check the vscs operator console listing), then 
VSCS will use the time value specified in the DTIGEN parameters. TIMEREL is used 
to determine when the printer will be released. (See VTAM Installation and 
Resource Definition for more information On TIMEREL.) 


If the correct value for TIMEREL is specified and vSCs was initialized with the 
proper DTIUSER module, then get the following documentation: 


e vscs dispatcher and VTAM exit traces 
e vscs dump 


® VTAM internal trace, OPT=API 
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¢ vTAM buffer contents trace for the printer logical unit before the Release 
was requested. 


Go to “Reporting Procedure” on page 68. 
5. Other printer problems: 
For problems not described above, get the following documentation: 
e vscs dispatcher and VTAM exit traces 
¢ VTAM internal trace, OPT=API 
e vscs dump. 


Go to “Reporting Procedure” on page 68. 


vm Operator Commands Are Rejected 
Does vscs reject a command that was entered correctly and issue an error 
message? You may have entered the command at an inappropriate time. For 
example, a VSCS START command is rejected when vscs is already active. Try using 
some other commands to see if they work. 


Note: Avoid using VSCS HALT, CANCEL, or QUIT; they could cause further problems. 


If the problem is unique to one command, or to a certain sequence of commands, 
get the operator console listing and go to “Reporting Procedure” on page 68. 
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Chapter 6. .w. Using VSCS Service Aids 


The following tools can help you diagnose vscs problems: 


e Messages 

¢ Operator console listing 

¢ Operator commands: BFRFIFO, QUERY, DISPLAY, FORCE, and STORAGE 
e vscs dump 

e vscs trace facility. 


These service aids, along with service aids for VTAM, can help you isolate problems 
to a single component and identify problems within vscs. 


vu Message and Module Conventions 


For most messages, the module name appears as the first word in the message 
text. For example, in message oTICo1I below: 


DTICINIT VSCS IUCV INITIALIZATION IS IN PROGRESS 


DTICINIT is the module name. If the module name is not given in the message text, 
see the message-to-module cross-reference in VTAM Messages and Codes for the 
module name. 


All vScS message and module identifiers begin with DTI. Module names are in the 
form DTicaaaa, where aaaa is the unique module identifier and c represents the 
issuing subcomponent, as follows: 


C Communication Services for Inter-User Communication Vehicle (iucv) 
F System Services 
Initialization and Termination Services 
P Presentation Services 
In this subcomponent ( DTiPaaaa), the fifth letter is one of the following: 
D Device manager 
Input manager 
O Output manager 
R Request services 
S State manager 
S System Services 
Vo sVTAM Services 
In this subcomponent, a module with the last character of x (DTIVaaax) indi- 
cates a VTAM exit routine. 


Message identifiers are in the form DTicnni, where c indicates the issuing compo- 
nent (as above), nn is the two-digit serial number, and /is the action indicator: 


A Action 
E Eventual action 
| Information. 
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For internal vScs errors, module DTIMSGE issues the following message: 
DTIS99I INTERNAL VSCS ERROR modname n 


where modname indicates the name of the module that issued the message, and n 
identifies the nth occurrence of DTIMSGE within the module. This number n can be 
used to identify the reason the message was issued. See “VM Message DTIS99I 
Indicates a VSCS Internal Error” on page 135 and VTAM Messages and Codes for 
more information. 


vu Operator Console Listing 


The operator console listing is a printout of the messages that appear at the vscs 
operator console. The listing contains everything that appears on the operator’s 
console during the entire session. It can help you find out the sequence of events 
when a problem occurs. If vSCS is running in the same virtual machine as vTAM, the 
console listing includes VTAM messages as well as vSCS messages. 


To obtain a console listing, issue the CP command SPOOL CONSOLE START. If you are 
using a hardcopy terminal, such as a 3767, this is not necessary because all input 
and output already comes out on paper. For more information on this command, 
see the VM/SP CP Command Reference. 


Note: If the operator console is in conmode 3270, the CP SPOOL CONSOLE Command 
produces no output. 


vu Operator Commands 


vm BFRFIFO Command 


152  VTAM Diagnosis 


BFRFIFO affects the dequeueing and dispatching structure for storage. Generally, 
storage is used from the top in a last-in-first-out fashion (BFRLIFO). This is the 
default. For diagnostic purposes, however, you can turn on BFRFIFO. This first-in- 
first-out method of storage preserves the queue long enough for you to see the ele- 
ments that have just been processed. 


To start BFRFIFO, use the VSCS BFRFIFO Command or the DTIGEN macro. For more 
information, see VTAM Operation. 


Note: Using BFRFIFO can seriously degrade system performance, especially in a 
large network. 
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vii DISPLAY Command 
The vscs command DISPLAY !D=luname shows the status of a logical unit. 
Figure 25 shows an example of the vSCS DISPLAY command. 


vscs display id=13e0 

Rs 

DTIS60I DISPLAY COMMAND ACCEPTED 

DTIS61I LU NAME = L3E0 DEVICE TYPE = 3277 MODEL = 2 
DTIS62I LU TYPE = 0 DEVICE FEATURES = NEDS APL( OLD ) 
DTIS63I SCREEN SIZE = 24 BY 80 ALTERNATE SIZE = BY PACE = 24 
OTIS65I IUCV PATHIDS = 2 3 CURRENT RPL COMMAND = SEND 

DTIS59I RECEIVE SPECIFIC RPL BUSY 

DTIS66I1 CURRENT STATES: PS = NMH VS = NORM ER 

DTIS67I LOGON TIME = 16: 05: 17 

DTIS68I SEND COUNT = 00000001 RECEIVE COUNT = 00000000 

DTIS771 VSCS COMMAND PROCESSING COMPLETE 


Figure 25. vv Example of the VSCS DISPLAY Command 


vei FORCE Command 
The vscs command FORCE ID =luname terminates the CP session and VTAM session 
for a logical unit. This command may be used when the CP FORCE and VTAM VARY 
INACT Commands do not terminate a logical unit. 


ve; QUERY Command 


The vSCS QUERY command displays the following information: 


e The location of the vscs trace table (if it has been allocated) 
¢ The status of vScs traces 

e The status of a vscs dump 

e The status of buffer queues. 


Figure 26 shows an example of the vSCS QUERY command. 


vscs query 

R; 

DTIS74I TRACE TABLE STARTS AT 001C5020 , ENDS AT O02BFO5F 

DTIS84I SELECTIVE TRACE ACTIVE FOR LOGICAL UNIT ELU3101 

DTIS84I SELECTIVE TRACE ACTIVE FOR LOGICAL UNIT LU1920 

DTIS87I SELECTIVE VTAM, DISPATCHER AND CCS TRACE ACTIVE FOR 2 LU(S), 30 
DTIS93I VSCS EXTERNAL TRACE IS ENABLED 

DTIS76I VSCS DUMP PROCESSING IS ENABLED 

DTIS78I BUFFER DEQUEUE IS IN NORMAL MODE(BFRLIFO) 

DTIS77I VSCS COMMAND PROCESSING COMPLETE 


Figure 26. vm Example of the VSCS QUERY Command 
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vmM STORAGE Command (V3R2) 


The vSCS STORAGE command shows the status of vScs dynamic storage, and some 
DTIGEN options that are in effect. 
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Figure 27 shows an example of the vSCS STORAGE Command when both STCHKTM and 
STRELTM are zero. 


vscs storage 


R; 

DTIS15] 
DTIS16] 
DTIS17I 
DTIS18] 
DTIS19] 
DTIS20] 
DTIS771 


DYNAMIC STORAGE UTILIZATION 


RCVBFRL - O0010C DPXMTL - QOQ6BC 
RPLNUM - 08 VSAMLM = - QOOA 
BLKMULT - 01 STCHKTM - Q00000 


GETMAIN - OQ000B FREEMAIN - Q00000 
VTAMSES - 000000 CPCONNS - 000000 
VSCS COMMAND PROCESSING COMPLETE 


KPXMTL 
VEIBS 
STRELTM 
SWAP 
CPMAX 


Q0010C 
000003 
800000 
000000 
000000 


Figure 27. VM Example of the VSCS STORAGE Command, STCHKTM =0 and STRELTM =0 


Figure 28 shows an example of the vSCS STORAGE command when either STCHKTM or 
STRELTM is greater than zero. 


vscs storage 


Ready; 

DTIS151 
DTIS16I 
DTIS171 
DTIS18I 
DTIS191 
DTIS20] 
DTIS21] 
DTIS22] 
DTIS22] 
DTIS221 
DTIS77I 


DYNAMIC STORAGE UTILIZATION 

RCVBFRL - Q00011C DPXMTL - 00079C 
RPLNUM - 08 VSAMLM = -:~QOOA 
BLKMULT - 08 STCHKTM - 000001 
GETMAIN - OOOQOA FREEMAIN - 000000 
VTAMSES - 000000 CPCONNS - 000000 
POOL HIGHWATER/VTAMSES CURRENT 
PS 000004 / 000000 000004 
VS 000001 / 000000 000001 
WX 000001 / 000000 000001 
VSCS COMMAND PROCESSING COMPLETE 


KPXMTL 
VEIBS 
STRELTM 
SWAP 
CPMAX 


AVAILABLE 
000002 
000001 
000000 


Q0011C 
000003 
QOOQ00A 
000000 
000000 
LIFO 


Figure 28. VM Example of the VSCS STORAGE Command, STCHKTM > 0 or STRELTM>0 
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vu VSCS Dump 


The vscs dump contains all of the storage for vscs. It also contains common, group 
control system (GCS), and VTAM Storage if they are in the same virtual machine as 
VSCS. 


To enable the dump, use the VSCS DMPENABL command or the DTIGEN macro. For 
more information, see VTAM Operation. With dumping enabled, vscs can create a 
dump as soon as an internal error occurs. This ensures that the proper data is 
recorded before recovery processing begins. If an abend occurs, vSCS creates a 
dump automatically, whether dumping is enabled or not. Use the GCs GDUMP 
command to obtain a dump of the vscs virtual machine for problems that do not 
Cause vSCcs to dump automatically. 


While the dump is being taken, all network activity temporarily stops in order to 
keep the contents of the dump intact. When the dump is requested, vscs issues a 
message containing the name of the module requesting the dump and a dump 
identifier number. vSCS dumps are numbered to correlate to the console mes- 
sages. 


Use the link-edit listing to locate key modules or work areas in the dump. The 
addresses of CSECTS DTIISDA1 and DTIISDA2 alSo appear in the trace table header 
record, as shown in Figure 31 0n page 162. DTIISDA1 and DTIISDA2 contain the global 
control blocks, which can be identified in the dump by their unique identifiers. For 
more information on control block identifiers, see “vmVSCS Storage and Control 
Block Identifiers” on page 659. 


vu Dump Formatting Routine 


VSCS provides a dump formatter to format vscs control blocks and the vscs internal 
trace table ina dump. The routine runs as part of PRTDUMP. 


1. Use the GCS GDUMP Command to dump VSCS storage. 
2. Use ipcs to process the reader file produced by the dump. 
3. Use PRTDUMP to format the vsScs control blocks and internal trace table. 


Note: Use the vScS QUERY command to find the location of the vscs internal trace 
table, and record its address. That way, if you cannot find the proper control 
blocks, you can still use the table’s address to find them via the dump formatter. 
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Five options allow you to choose what portion of the dump you want to format: 


1 2 3 4 § 
Trace table DTIPDBs DTITAB Trace table Module list 
DTIPRM DTISDBs DTIPIBs 
DTISAB SCB summary ODTIPLB 
DTICGB DTICLB 
DTIPGB DTIVLB 
DTIVGB Send RPL 
DTIGTD DTIWEB 
DTISCB DTIVEIB 
DTIUGB DTICMT 
DTICIA DTIXMT 
DTICMDs Logical unit 
DTISWBs trace 
DTIPACT entries 
DTIDSBs 
VTAM work 

area 
Path table 
DTITABs 
DTIPIBs 
DTIPLBs 
DTICLBs 
DTIVLBs 
Send RPL 
SCB summary 


Formatting may terminate if the following conditions occur: 


e lf vscs cannot find the control blocks in the dump. Early in initialization and 
late in termination, the appropriate pointers and exits may not exist. If vscs 
cannot find the control blocks, it issues a message asking you for the vscs 
trace table address. From this, it can locate the control blocks. 


e¢ {If validity checking shows that a control block has been overlaid with data. 
¢ lf a page of storage that vscs needs is unavailable. 


if formatting fails, you may print the dump unformatted. 


Figure 29 on page 157 shows how to use the dump formatting routine. It is taken 
from an operator console listing. 
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prtdump prb00001 


PROCESSING FILE 'PRBOOOQO1 DUMP’ 
CSIIPR550R DO YOU WISH TO FORMAT VTAM CONTROL BLOCKS? REPLY YES OR NO 


y 
FORMAT VSCS CONTROL BLOCKS? (YES OR NO) 


y 


DTIFTO4 - VSCS DUMP FORMATTING 

DTIFTO5 - VSCS CONTROL BLOCKS LOCATED 

DTIFTO1 - VSCS DUMP FORMATTING OPTIONS 

1. TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 
STORAGE CONTROL BLOCKS 

SPECIFIC LU CONTROL BLOCKS 

VSCS TRACE TABLE ONLY 

VSCS MODULE CROSS REFERENCE LISTING 

PRINT ENTIRE DUMP 

EXIT 


Oo 7D MM HP W PP 


ENTER OPTION(1-5) P-PRINT OR Q-EXIT: 


3 
ENTER LUNAME(1-8 CHARACTERS) : 


vtam 


DTIFTO3 - FORMATTING VTAM LU CONTROL BLOCKS 
DTIF204 - SEARCHING FOR LU.... 

DTIF205 - EXTRACTING LU TRACE ENTRIES... 
DTIF201 - LU NAME VTAM PROCESSED 

DTIFTO1 - VSCS DUMP FORMATTING OPTIONS 

1. TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 
STORAGE CONTROL BLOCKS 

SPECIFIC LU CONTROL BLOCKS 

VSCS TRACE TABLE ONLY 

VSCS MODULE CROSS REFERENCE LISTING 
PRINT ENTIRE DUMP 

EXIT 


Oo 7 NN FP W PP 


ENTER OPTION(1-5) P-PRINT OR Q-EXIT: 


5 


DTIFTO9 - SEARCHING FOR MODULE NAMES 

DTIFT10 - SORTING MODULE NAMES... 

DTIFTO1l - VSCS DUMP FORMATTING OPTIONS 

1, TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 
. STORAGE CONTROL BLOCKS 

. SPECIFIC LU CONTROL BLOCKS 

. VSCS TRACE TABLE ONLY 

VSCS MODULE CROSS REFERENCE LISTING 

. PRINT ENTIRE DUMP 

y. TEAL 


Oo DM & W PP 


Figure 29 (Part 1 of 2). VM Using the VSCS Dump Formatting Routine 
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ENTER OPTION(1-5) P-PRINT OR Q-EXIT: 


, 
DTIF101 - SHOULD THE VSCS INTERNAL TRACE TABLE BE FORMATTED? Y]N 
n 


DTIFTO1 - VSCS DUMP FORMATTING OPTIONS 

1. TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 
STORAGE CONTROL BLOCKS 

SPECIFIC LU CONTROL BLOCKS 

VSCS TRACE TABLE ONLY 

VSCS MODULE CROSS REFERENCE LISTING 

PRINT ENTIRE DUMP 

EXIT 


Oo OTN SS W MP 
¢- e# @®  @  @  @ 


ENTER OPTION(1-5) P-PRINT OR Q-EXIT: 


2 


DTIFTO1 - VSCS DUMP FORMATTING OPTIONS 

1. TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 
STORAGE CONTROL BLOCKS 

SPECIFIC LU CONTROL BLOCKS 

VSCS TRACE TABLE ONLY 

VSCS MODULE CROSS REFERENCE LISTING 

PRINT ENTIRE DUMP 

EXIT 


Oo 90 NN WwW PA 
oo @ #@ @ @  @ 


ENTER OPTION(1-5) P-PRINT OR Q-EXIT: 


3 
ENTER LUNAME(1-8 CHARACTERS): 
vtam 


DTIFTO3 - FORMATTING VTAM LU CONTROL BLOCKS 
DTIF204 - SEARCHING FOR LU.... 

DTIF205 - EXTRACTING LU TRACE ENTRIES... 
DTIF201 - LU NAME VTAM PROCESSED 

DTIFTO1 - VSCS DUMP FORMATTING OPTIONS 

1. TRACE, GLOBAL AND LU RELATED CONTROL BLOCKS 
. STORAGE CONTROL BLOCKS 

SPECIFIC LU CONTROL BLOCKS 

VSCS TRACE TABLE ONLY 

VSCS MODULE CROSS REFERENCE LISTING 
PRINT ENTIRE DUMP 

EXIT 


Oo 70 ON PP WwW PP 
e @e@# @  @® €& 


ENTER OPTION(1-5) P-PRINT OR Q-EXIT: 


q 
FORMAT VTAM CONTROL BLOCKS? (YES OR NO) 


n 


Figure 29 (Part 2 of 2). YVMUsing the VSCS Dump Formatting Routine 
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The general format of control blocks in a formatted dump is: 


Control block name and address 
Control! block information 
ORI SOL: waeeded es data in dump format......... *,.printable..* 


vu VSCS Trace Facility 
The vscs trace facility offers the following trace options: 


¢ ccs (Console Communications Services) 
e Cleanup 

¢ Data (V3R2) 

¢ Dispatcher 

e¢ FRE (V3R2) 

© GET (V3R2) 

© VTAM exit. 


All of the traces except cleanup are started with operator commands. (For the ccs 
and VTAM exit trace options, the default is active.) The cleanup trace starts auto- 
matically with any of the other traces. 


The following list shows when each kind of trace entry is created: 


ccs trace Creates one entry for each iucv request or response sent or 
received by VSCs. 


Cleanup trace Creates one or two entries for each logical unit at logoff or dis- 
connect. This trace is activated automatically when one or 
more of the other traces is activated. It cannot run by itself. 


Data trace (v3R2) Creates one entry for logical unit-bound data (output), and one 
entry for ccs-bound logical unit data (input). 


Dispatcher trace Creates one entry each time DTIPSTAM Or DTIVSTAM gives control 
to another module to process a work element block. This can 
occur more than once for a single work element block. 


FRE trace (V3R2) Creates one entry for each request to free a block of storage. 
GET trace (V3R2) Creates one entry for each request for a block of storage. 


VTAM exit trace Creates one entry each time VTAM gives control to a VSCS VTAM 
exit. 


Figure 30 on page 160 shows where each trace occurs. 
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System Services | 


VTAM 
API 


Data 


| 
Dispatcher 


SP Cleanto __ 


VTAM Exit 


Figure 30. VM The VSCS Traces 


vscs records the data in an internal table that wraps around when full. The size of 
the trace table is variable and is specified during vScs initialization. The default 
size is 1000 records of 32 bytes each. 


The external trace option prevents trace information from being overlaid when the 
internal table wraps. If MODE=EXT, VSCS maintains both the internal trace table and 
the external trace table. This ensures that a dump taken for an unrecoverable 
error will contain the relevant data from the internal trace table. The external vscs 
trace entries are sent to CPTRAP. See “vm How to Run External VSCS Traces” on 
page 161 for information on obtaining the external trace output. 


Storage for the trace table is not allocated until the trace is activated and tracing 
begins. When the trace facility is turned off, storage for the trace table is pre- 
served and can be dumped by the operator using the cP DUMP command. The vscs 
QUERY Command gives the starting and ending address of the trace table. In addi- 
tion, the trace table can be found through a pointer at SABTRHDRA in the DTISAB. See 
“ym How to Run External VSCS Traces” on page 161 and VTAM Operation for 
information on starting the vSCs traces. 


vm Trace Degradation 


160 VTAM Diagnosis 


Each trace option causes some system degradation, but it can be controlled to 
some extent. The cleanup and CCS traces cause the least system degradation. The 
VTAM exit trace causes a little more; and the data, dispatcher, FRE, and GET traces 
cause the most. That is why CCs is the default. 


If one or very few logical units are experiencing a problem, and you are re-creating 
the problem to get documentation, run the traces on only one logical unit. This 
reduces the impact of the trace on system performance and reduces the frequency 
of the trace table wrapping. 
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vw How to Run External VSCS Traces 
To run the vscs traces externally, issue the following commands from the vscs 
console: 


CPTRAP 3D 
CPTRAP GROUPID gcsgroup 
CPTRAP START TO userid userid is the receiver of the spool file 


VSCS TRACEON (EXT ALL EXT means run the trace externally. ALL means turn on 
the ccs, data, dispatcher, FRE, GET, and VTAM exit trace 
options. 


VSCS TRACEON luname This is required only for selective tracing. 


VSCS Starts tracing to a spool file. When you have collected enough data and you 
want to stop tracing, issue the following commands from the vscs console: 


VSCS TRACEOFF (EXT ALL Turn off external tracing. 


VSCS TRACEON * Turn off selective tracing. This command is needed 
only if selective tracing was used above. 


VSCS TRACEON (CCS Activate the ccs trace option and use the internal trace 
table. It is recommended that you run with this 
minimum trace at all times. 


CPTRAP STOP 


CP spools a file to the reader of the user iD specified in the CPTRAP START command. 
Use TRAPRED to look at the output as follows: 


ts bf 


ACCESS 193 x The ccs formatting routines are on this disk. “x” isa 
user-specified file mode. 


TRAPRED fileno “fileno” is the reader file number (Q RDR). (Make sure 
the reader file is not in hold status.) 


3D Read VTAM and VSCS records only. 
FORMAT Format the records. 
PRINTER 999999 Print the records. (There are other commands which 


allow you to view the cPTRAP file online. See the VM/SP 
System Programmer's Guide for VM R4, or the VM/SP 
Facility for System Programming for VM Rs.) 


QUIT 


vm VSCS Trace Table 


A trace may be started for one logical unit, up to 32 specific logical units, or all 
logical units at any time. If a trace is running for all logical units and the TRACEON 
command is specified for a single logical unit, then the trace only records data for 
the logical unit specified. In the same manner, if you are tracing a specific logical 
unit and issue TRACEON ALL, the trace now records data for all logical units. 
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The vSCS QUERY Command shows: 


e What traces are active 

e Which logical units are being traced (if selective tracing is used) 
e Which trace options are in effect 

¢ The location of the internal trace table (if it is allocated). 


vm Trace Table Header 
The vscs trace table contains a header record (OTITHDR) followed by the trace 
records (DTITREC). Figure 31 shows the trace table header. 
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00 


04 


08 


Oc 


10 


14 


18 


IC 


20 


24 


28 


2C 


30 


34 


38 


at 


[Tne 


Figure 31. VM VSCS Trace Header Format 


The header shows this information: 


Byte (hex) Contents 


00-01 
02-03 
04-08 
08 — 0B 
OC — OF 
10-13 
14-17 
1A 
20-23 
24-27 


DTITHDR element header (TR) 

Number of entries in table 

Zero 

Pointer to current entry in table 

Pointer to first entry in table 

Pointer to last entry in table 

Address to be used in freeing the trace table storage 
Zero 

Address of DTIISDA1 

Address of DTIISDA2 
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28- 2B Address of DTIISTRT 
2G 2F Address of DTIIPATCH 
30-33 Address of DTIIPARM 
34 — 3F Zero 


vw Examples of VSCS Trace Output 


There are three ways to look at the vscs trace table: 


e Online at the operator console 
e In dump output 
e Formatted with TRAPRED. 


1. To view the trace table online, issue the VM DISPLAY command from the vscs 
operator console. (For more information on this command, see the VM/SP CP 
Command Reference.) Figure 32 on page 164 shows an example of the 
output. (The trace record titles were added to identify the different trace entry 


types.) 


Note: You can also use TRAPRED to view the output online. The output looks the 
same whether you use the VM DISPLAY command or TRAPRED. See the VM/SP 
System Programmer's Guide (for VM R4) or the VM/SP Facility for System Pro- 
gramming (for VMR5) for more information about TRAPRED. 


2. Figure 33 on page 165 shows what the trace table looks like in dump output. 
(The trace record titles were added to identify the different trace entry types.) 


3. Figure 34 0n page 166 shows an example of a VSCS trace running externally 
and formatted with TRAPRED. (The procedure for obtaining this output is 
described in “ vmHow to Run External VSCS Traces” on page 161.) For more 
information on using TRAPRED, see the VM/SP System Programmer's Guide. 
(for VM R4) or the VM/SP Facility for System Programming (for VM Rs). 
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164 VTAM Diagnosis 


Storage 

Address 
Trace header 

15E020 E3D97F58 00000000 0015E780 0015E060 i I: gare ener ) as 

15E030 0025CB40 0015E008 00000000 00000000 Fae sheaetmaannereees * 

15E040 0013A948 001588F8 0012E000 O0015C0D8 Pain eutee Sivaesete Q* 

15£050 0013A568 00000000 00000000 00000000 © rath oroeoe Seager. x 
VSCS CCS data trace entries 

15E060 C3D5C3E3 00012000 O00A0D000 5CC3C3E2 SONG ste aat urinels *CCS* 

15E070 40404040 01010000 OO000000A £5D44040 ee eee VM * 
VSCS CCS global trace entries 

15E080 00125028 00000001 C7D3C2D3 D9010310 ruila se cacazte GLBLR...* 

15E090 = OCOQ0000 00110000 O0000000 E2E240C5 ee eee 55: E% 
VSCS VTAM exit trace entries 

15EQAO E5D3D6C7 00124028 001241B8 00001910 SVLUGia: areew a aes * 

15E0BO 00008000 00000000 10000000 00000000 Rid OSes bias aoerlears x 

15EO0CO E5D6D7D5 00124028 171241B8 00000000 PVOPN os: SAuaieste ste * 

15EO0D0 10758000 90000000 10000000 00070002 Digg org aoera eee Sateen : 
VSCS dispatcher trace entries 

15EOEO D7020704 00124028 00127028 80000000 Pita ot Ceraears ‘ 

15EOFO 00000000 00000010 O0000000 E2C9D5E3 Cute useaeees SINT* 

15E100 D7020000 00124028 401254E0 81000080 Oi Gane 2! aa eae . 

15E110 Q00001D00 00000010 Q0000000 D6E6D9IE3 Ps die Sicsho hecad OWRT* 

15E120 £5031004 00124028 40250028 81000080 Vitis Gi, “A, de wives gs 

15E130 00000000 00000010 QO0000000 E2C5D5C4 as eer eee SEND* 
VSCS CCS LU trace entries 

15E220 OO11E2BO 00020000 10751054 F2830009 cg Sie ete news Oak 

15E230 01000001 00020000 00000000 40040050 Wuidiatel austere gta ee && 

15E240 0011E£310 00020000 10751054 C3830002 Wile | bb eceravahe aus Ck. 

15E250 OE000000 00040000 90000000 00040000 Pi Rho tel Rie nue oe erelae 
VSCS cleanup trace entries 

15E6CO D7D9C2D2 02124028 00840000 80000000 TPRONGs aeeaun ees 

15E6D0 00000000 O0000000 10751054 0025F188 DM idiee wee earns 12% 


Figure 32. vMVSCS Trace Records Displayed at the Operator Console 
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686L ‘P86L “diodg Wal }1YyYBI4AdoD © 1-1L09S-0€A7 


SPIY BDIAI8S SOSA Bulsq WA °9 4a}deUD 


S9l 


INdINC dwng u! sps0Odsy 99B1] SOSAWA ‘SE aunBl4 


STORAGE 


ADDR 


13E020 
15E040 


1SEO60 


1SEO8O 


1 SEQAO 
1SEOCO 


1SEOQEO 
15E100 
15E120 


1SE220 
15E240 


1SE6CO 


Trace header 


E3D97F58 OOO000000 0015E780 0015E060 


0013A948 001588F8 0012E000 0015C0D8 


VSCS CCS data entry 


C3D5C35E3 00012000 OOOAD000 SCC3C3E2 


VSCS CCS global trace entry 


00125028 O0000001 C7D3C2D3 09010310 


VSCS VTAM trace entries 


ES5D3D6C7 00124028 001241B8 
t€5D6D07D5 00124028 171241B8 


VSCS Dispatcher trace entries 
D7020704 00124028 00127028 


D7O20000 00124028 401254E0 
E5031004 00124028 4025D028 


VSCS CCS trace entries 


0011E2BO 00020000 10751054 
0011E310 Q0020000 10751054 


VSCS Cleanup trace entry 


D7D9C2D2 02124028 00840000 


00001910 
OOQ00000 


80000000 
81000080 
81000080 


F2830009 
C3830002 


80000000 


0025C840 0015E008 d0000000 
001 3A568 QO0000000 O0000000 


40404040 01010000 OOOO000A 


OCO00000 


00008000 
10758000 


O0O00000 
00001D00 
00000000 


01000001 
OEOOCO0N 


00000000 


00110000 


00000000 
O0000000 


00000010 
00000010 
00000010 


00020000 
00040000 


Q0000000 


00000000 


10000000 
10000000 


Q0000000 
OOCO0000 
OOO000000 


OO0000000 
O0O000000 


10751054 


00000000 
OOCO0000 


E5D44040 


E2E24CC5 


OO000000 
00070002 


E2C9DSE3 
D6E6D9E3 
E2C5D5C4 


40040050 
00040000 


0025F 188 


*VOPN.. 
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iW] JO SIPHOEW PodyjsayY,_,, 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


3D OF VTAM VM/GCS USER REQUESTED GTRACE 
TIME OF DAY CLOCK = 9A1222FFE3ABCO00 
LENGTH OF GTF HEADER AND TRACE DATA = 0030 
FORMAT ROUTINE ID = F5 
EVENT IDENTIFICATION = EFAA 
VREC RTN CODE GO TAB 179840 RPLREQ 23 RPL 17627C RPLFDBK 0000 RPLSENS 0000 NAU 0100 
PS STATE 00 PLBSM 00 00 00 00 VS STATE 00 VLBSWAP 30 80 00 00 VLBLRCD 00 EXIT DATA 04 00 00 
3D OE VTAM VM/GCS USER REQUESTED GTRACE 
TIME OF DAY CLOCK = 9A1222FFE727C000 
LENGTH OF GTF HEADER AND TRACE DATA = 0030 
FORMAT ROUTINE ID = F5 
EVENT IDENTIFICATION = EFAA 
PDISP LBCSTTUS 02 WEBFUN 04 WEBMODE 04 WEBVSRPS 7D TAB 179B40 WEB 17A9C8 PS STATE 00 PLBSM 60 00 98 O00 PLBDFLG 02 
PLB- OFLG1 00 NOM 00 00 EDIT 00 PLBIA 00 VS STATE 00 VLBSWAP 30 80 00 00 VLBLRCD 00 MODULE IKIN 
3D OE VTAM VM/GCS USER REQUESTED GTRACE 
TIME OF DAY CLOCK = 9A1222FFEBEF8000 
LENGTH OF GTF HEADER AND TRACE DATA = 0030 
FORMAT ROUTINE ID = F5 
EVENT IDENTIFICATION = EFAA 
CCS WEB = 17A9C8 PATHID 0003 0006 CID 0100 QOOA TYPE Y PS STATE 00 WEBCOUNT 0003 WEBFUN 04 WEBMODE 00 
WEB- CHAR OO EDIT QO FLAGS 00 04 LINE QO@A CURSR 0000 TABCH 00 WEBRSVSA 00 WEBDATA 172FB100 *....* 


Figure 34. vMVSCS Trace Records Formatted with TRAPRED 


vu VSCS CCS Trace Record Format 
When the cCs trace option is active, vSCs traces all traffic to and from ccs. You can 
limit the Ccs trace to a selected set of logical units when you start it. The ccs trace 
produces three types of record formats: 


Logical unit-related for traffic associated with logical units 
Global for traffic not associated with a logical unit 
Data for traffic associated with logical units or global traffic. 


vm Format for a CCS Trace Entry for a Logical Unit 


: 


Displacement: 


00 Zero 
01-03 Address of DTIWEB associated with this request or response 
04-07 Path 1D from Communication Services local block (CLB) 


04-05 VSCS path ID 
06—07 CCS path!ID 
08—-OB VTAM communication identifier (CID), either OAF or DAF 
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OC 


0D 


OE — OF 
10 


11 


12 


13 


Fiow indicator 


R (Receive) 

Y (Reply) 

1 (1-way send) 
2 (2-way send) 
T (Reject) 


C (Message complete) 
Note: In this book, whenever a flow is referred to as inbound or out- 
bound, you should take the Console Communications Services (CCS) 
as the reference point. That is, flows toward the CCS are inbound; 
flows away from the CCS are outbound. 

LBCSTATE from PLB (See “vmLBCSTATE Values for PLBINxxx” on 


page 214.) 


WEBCOUNT 
WEBFUN 


WEBMODE 


WEBCHAR 


WEBEDIT 
116 ie ree 
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LBCINT 


LBCFSSMF 


LBCFSAV 
LBCFSII 


LBCCOPY 
LBCNAL 
LBCHOLD 
LBCM10 
LBCM50 
LBCCMSD 


Flow direction 


CCS => VSCS (outbound) 
VSCS = > CCS (inbound) 
VSCS = > CCS (inbound) 
VSCS => CCS (inbound) 
VSCS = > CCS (inbound) 
CCS => VSCS (outbound) 


Internal mode if on (on=1). If LBCINT is 
on, see “vmLBCSTATE Values for 
PLBINxxx” on page 214. If LBCINT is off, 
the following values apply: 

Full-screen support mode flags 

Screen available 

Full-screen input inhibited: 


B‘00’ CP (Console) mode 

B‘Ot’ Virtual machine mode state 
between ATTN and READ, 
QUEUE CP messages. 

B‘10' Virtual machine mode queue CP 
messages. 

B11’ Virtual machine mode available 
for switch. 

Copy mode: on=1 

NAL flag: on=1 

Holding flag: on=B'11’ 

‘More’ 10 flag: on=1 

‘More’ 50 flag: on=1 

Screen written with a CMS DIAGNOSIS: 

on=1 

No more holding state 


Length of actual data in WEBDATA 
WEB function code. This is explained in “vM WEB Func- 
tion Codes” on page 215. 


Mode: 


00 Console 


01 CMS 


02 Full-screen 


04 Internal 


Character set (set by CCS for Console and CMS modes) 


00 EBCDIC character set 
O01 APL character set 

02 TEXT character set 
Editing characteristics 


Zero 


Chapter 6. vmUsing VSCS Service Aids 167 


14 


15 
15 


16-17 
16 
17 
18—19 


1A 
1B 


1C—1F 
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1i.. 


WEBCPFLG 
WEBSAFLG 


WEBLINE 
WEBLAID 
WEBNLLOS 
WEBCURSR 


WEBTABCH 
WEBRSVSA 


WEBDATA 


WEBMIEKO 


WEBEDPTI 
WEBNOEKO 
WEBEDCUP 


WEBRSV1 
WEBCONMD 
WEBLED 
WEBANFSW 


WEBDIAL 


WEBNOMOR 


wEBPRMPT 
WEBPASPA 
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Highlight input display 


Do not print or do not display 
Do not redisplay input on next output line 
Convert to upper case 


Zero 

Request for display in conmode 3270 
Lirhited edit diagnose 

Allow any full-screen write; first full- 
screen write after reset. 

SNA dialed logical unit 


CMS ERASE WRITE NO ‘MORE’ 
requested 

WEBDATA contains pre-logon prompt 
Pass PA1 (FSSM) as data to application 


ccs status flags for VSCS 
VSGS status flags 


WEBCPACR 
wEBCPPRI 

WEBCPALM 
wEBSAHLD 
WEBCPMDE 
WEBSAMOR 
WEBOPHLW 
wisécbaspe 
WEBSARSP 
WEBSCPARR 
WEBSARRR 
WEBCPRNR 
WEBSARNA 


No carriage return (hardcopy terminal) 
Priority flag 

Ring the alarm 

Holding 

CP-generated bit = 1 

‘More’ VM-generated bit = 0 
Highlight write requested 

Indicatés CCS response 

Indicates VSCS response 

CCS request, requires response 
VSCS request, requires response 
CCS request, requires no response 
VSCS réquest, requires no response 


Lidé Aumber for CMS WEBCMWRT 

Logical attention identifier 

Nurnbet of lines left on screen 

Cursof position may be a relative address or a buffer 


address 


Tab (not DTITAB) character 


Reserved 

wEBCPRDS 
WEBNOVCK 
WEBATTNW 


WEBCHDIR 
WEBMASKW 


DTIWEB is a redisplay DTIWEB 

Do not validity check data 

Attention write (VSCS only) yes = 1 
Zero 

Change direction required 

Write inhibit mask 

Zero 


First fout bytes of data field 
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vm Format for a Global CCS Trace Entry 


A global entry occurs If CCS receives a request for a path ID that has been severed. 


Displacement: 


00 
01-03 
04-07 


08 — 0B 
0C 


0D 
OE — OF 
10 


11 


13 


Zero 


PATH IDs 
re 


Address of DTIWEB associated with this request or response 
Path ID (from CLB) 


04—05 VSCS path ID 
06-07 CCS path ID 
Characters ‘GLBL' 


Flow indicator 

R (Receive) 

Y (Reply) 
(1-way send) 

2 (2-way send) 

T (Reject) 


Flow direction 


CCS => VSCS 
VSCS => CCS 
VSCS => CCS 
VSCS => CCS 
VSCS => CCS 


C (Message complete) CCS => VSCS 


WEBCAN 
WEBCOUNT 
WEBFUN 


WEBMODE 


WEBCHAR 


WEBEDIT 
1 i reer 
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Number of control areas 

Length of actual data in WEBDATA 

WEB function code. This is explained in “ya WEB Func- 
tion Codes” on page 215. 

Mode: 


00 Console 

01 CMS 

02 Full-screen 

04 Internal 

Character set (set by CCS for Console and CMS modes) 


00 EBCDIC character set 
01 APL character set 
02 TEXT character set 


Editing characteristics 
Zero 
WEBHIEKO ~— Highlight input display 
WEBEDPTI Do not print or do not display 
WEBNOEKO Do not redisplay input on next output line 


Chapter 6. vmUsing VSCS Service Aids 169 


14 


15 


16-17 
16 
17 
18—19 


1A 
1B 


1C—1F 
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WEBLINE 
WEBLAID 
WEBNLLOS 
WEBCURSR 


WEBTABCH 
WEBRSVSA 


WEBDATA 


WEBEDCUP 


WEBRSV1 
WEBCONMD 
WEBLED 
WEBANFSW 


WEBDIAL 
WEBNOMOR 


WEBPRMPT 
WEBPASPA 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Convert to upper case 


Zero 

Request for display in conmode 3270 
Limited edit diagnose 

Allow any full-screen write; first full- 
screen write after reset. 

SNA dialed jogical unit 

CMS ERASE WRITE NO ‘MORE’ 
requested 

WEBDATA contains pre-logon prompt 
PA1 (FSSM) pass as data to application 


CCS status flags for VSCS 


WEBCPNCR 
WEBCPPRI 
WEBCPALM 
WEBSAHLD 
WEBCPMDE 
WEBSAMOR 
WEBCPHLW 
WEBCPRSP 
WEBSARSP 
WEBCPRRR 
WEBSARRR 
WEBCPRNR 
WEBSARNR 


No carriage return (hardcopy terminal) 
Priority flag 

Ring the alarm 

Holding 

CP-generated bit = 1 

‘More’ VM-generated bit = 0 
Highlight write requested 

Indicates CCS response 

Indicates VSCS response 

CCS request, requires response 
VSCS request, requires response 
CCS request, requires no response 
VSCS request, requires no response 


Line number for CMS WEBCMWRT 

Logical attention identifier 

Number of lines left on screen 

Cursor position may be a relative address or a buffer 


address 


Tab (not DTITAB) character 


Reserved 

WEBCPRDS 
WEBNOVCK 
WEBATTNW 


WEBCHDIR 
WEBMASKW 


DTIWEB is a redisplay DTIWEB 

Do not validity check data 

Attention write (VSCS only) yes = 1 
Zero 

Change direction required 

Write inhibit mask 

Zero 


First four bytes of data field 
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vM Format for CCS Data Trace Entries 


0 4 


Header 


Data 


Displacement: 


00 —03 


Header 
‘ACNT' 
‘CMSG' 
‘CNCT' 
‘CXIT’ 
‘GMSG’ 
‘LIER’ 
‘SCNT’ 
‘SEVR’ 


// 


/} 


Accept connection 
Completion of a 1-way send 


Connect 


Invalid external interrupt 
Ignored traffic on global path 
Logical interface error 
Sever connection 


Sever 


04—1F First 28 bytes of data from area passed 


ACNT Entry: Accept connection, ccS = > vscs 


0 4 


‘ACNT' 


8 


Module ID 


Displacement: 


00-03 
04-07 


08 —0B 
0C — OD 
OE 


C 


lF 
CCS => VSCS 
CCS => VSCS 
VSCS => CCS 
CCS => VSCS 
CCS => VSCS 
CCS => VSCS 
CCS => VSCS 
VSCS => CCS 
or 
CCS => VSCS 
1F 


IUCV parameter list 


Characters ‘ACNT’ 
Last four characters of module making trace entry. First four charac- 
ters are always DTIP. 


Zero 
Path ID 
IPFLAGS1 


IPTYPE 
IPSMGLIM 
Zero 
IPAUDIT 
IPAUDIT1 
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IPALL 
IPQUSCE 
IPPRTY 
IPNORPY 
IPCPENTY 
IPFGMID 
IPFGPID 
IPFGMCL 


Quiesce, resume, and sever all 
Connect in quiesce mode 
Priority message, reply required 
One-way protocol 

Entry from CP 

Message ID specified 

Path ID specified 

Message class specified 


External interrupt code 


Message limit 


Audit trail as follows: 
Audit trail byte 1 


IPADRPLE 


Reply too long for buffer 
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15 


16-17 
18-18 
1C—1F 


Zero 
User data 


IPADSNPX 


IPADSNAX 
IPADANPX 
IPADANAX 
IPADRJCT 
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Protection exception on send buffer 


Address exception on send buffer 
Protection exception on answer buffer 
Address exception on answer buffer 
Message was rejected 

Zero 


Audit trail byte 2 


IPADRCPX 
IPADRCAX 
IPADRPPX 
IPADRPAX 
IPADSVRD 


Protection exception on receive buffer 
Address exception on receive buffer 
Protection exception on reply buffer 
Address exception on reply buffer 
Path was severed 

Zero 


First four bytes of logical unit name 


CMSG Entry: Completion of a one-way send, ccs = > vscs 


0 4 


8 


'CMSG' |Module ID 


Zero 


Cc 


LF 


IUCV parameter list 


Displacement: 


00 — 03 
04-07 


08 — 0B 
0C -0D 
OE 


OF 
10-13 
14-17 
14-15 
14 
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Characters ‘CMSQ’ 


Last four characters of module making trace entry. First four charac- 
ters are always DTIP. 


Zero 
Path ID 
IPFLAGS1 


IPTYPE 
IPMSGID 
IPTRGCLS 
IPAUDIT 
IPAUDIT 1 


IPALL 
IPQUSCE 
IPPRTY 
IPNORPY 
IPCPENTY 
IPFGMID 
IPFGPID 
IPFGMCL 


Quiesce, resume, and sever all 
Connect in quiesce mode 
Priority message, reply required 
One-way protocol 

Entry from CP 

Message ID specified 

Path ID specified 

Message class specified 


External interrupt code 


Message ID 
Target class 


Audit trail as follows: 
Audit trail byte 1 


IPADRPLE 
IPADSNPX 
IPADSNAX 
IPADANPX 


Reply too long for buffer 

Protection exception on send buffer 
Address exception on send buffer 
Protection exception on answer buffer 
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as ara IPADANAX Address exception on answer buffer 
ery ee IPADRJCT Message was rejected 
Meee 11 Zero 
15 IPAUDIT2 Augit trail byte 2 
Toes. eos IPADRCPX Protection exception on receive buffer 
sl eee: aces IPADRCAX Address exception on receive buffer 
pel boseduee IPADRPPX Protection exception on reply buffer 
gals lees IPADRPAX Address exception on reply buffer 
= Dias IPADSVRD Path was severed 
wigs ‘s 111 Zero 
16-17 Zero 
18-—1B IPBFADR1 Address of buffer 1 
1C—-1D Zero 
1E—-1F IPBFLNI Length of buffer 1 


CNCT Entry: Request for conngction, vscs = > ccs 
0 4 1F 


IUCY parameter list 


Displacement: | 


00-03 Characters ‘CNCT’ 
04-05 Path ID 
06 IPFLAGS1 
| ee IPALL Quiesce, resume, and sever all 


lick -aasrae IPQUSCE 
ale, hisses IPPRTY 


Connect in quiesce mode 
Priority message, reply required 


we dy whe IPNORPY One-way protocol 
g "haere IPCPENTY Entry from CP 
ches IPFGMID Message ID specified 
vay dhe IPFGPID Path ID specified 
eee we “ah IPFGMCL Message class specified 

07 IPRCODE Return code 
08-09 IPSMGLIM Megsage limit 
0A IPFCNCD Function code 
0B Zero 
0C-13 IPVMID Target virtual machine ID 
14-1B ‘*CCS' 
1C—1F First four bytes of logical unit name 
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CXIT Entry: Invalid external interrupt, ccs = > vscs 


0 4 


‘CXIT' 


Displacement: 


00-03 Characters ‘CXIT’ 


04-05 
06 


07 
08 -0B 
OC — OF 
0C —0D 
0c 


0D 


OE — OF 
10-13 
14-15 
16-17 
18—1B 


Path [D 
IPFLAGS1 


IPTYPE 
IPMSGID 
IPTRGCLS 
IPAUDIT 
IPAUDIT1 


cose wohl 
IPAUDIT2 


IPBFADR1 


IPBFLN1 
IPSRCCLS 


IPALL 
IPQUSCE 
IPPRTY 
IPNORPY 
IPCPENTY 
IPFGMID 
IPFGPID 
IPFGMCL 


1C 10 iF 


Bytes 0-23 of external parameter list 


Quiesce, resume, and sever all 
Connect in quiesce mode 
Priority message, reply required 
One-way protocol 

Entry from CP 

Message ID specified 

Path ID specified 

Message class specified 


External interrupt code 


Message ID 
Target class 


Audit trail as follows: 
Audit trail byte 1 


IPADRPLE 
IPADSNPX 
IPADSNAX 
IPADANPX 
IPADANAX 
IPADRJCT 


Reply too jong for buffer 

Protection exception on send buffer 
Address exception on send buffer 
Protection exception on answer buffer 
Address exception on answer buffer 
Message was rejected 

Zero 


Audit trail byte 2 


IPADRCPX 
IPADRCAX 
IPADRPPX 
IPADRPAX 
IPADSVRD 


Zero 


Protection exception on receive buffer 
Address exception on receive buffer 
Protection exception on reply buffer 
Address exception on reply buffer 
Path was severed 

Zero 


Address of buffer 1 


zero 


Length of buffer 1 


Source class 
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1C 


1D—1F VEIB Address 


DTICEXIT 


Error code point 


01 VSCS abnormally terminating 

02 Pending connect received - not supported 

03 Error dequeueing VEIB or no available VEIBs 

04 Error enqueueing VEIB on CGBCGMQ 

05 Error found - not specific 

06 Error enqueueing or dequeueing 

07 Scheduling with priority failed 

08 Scheduling failed 

09 No match found for path ID in VSCS path table 

0A Control block address passed does not point to a valid VSCS 
contro! block (SAB or TAB) 

OB Storage shortage obtaining additional VEIBs 

0C Storage shortage obtaining additional VEIBs 


GMSG Entry: Traffic on global path is ignored, ccs = > vscs 


0 4 


1Cc 1F 


Bytes 0-23 of external parameter list 


Displacement: 


00-03 Characters ‘GMSG’ 


04-05 Path ID 
06 IPFLAGS1 
Ligcie’ Sewie 
we Lise 
wool. . 
aoe eee 
« dees 
el... 
vals 
Sigel: “Sake ] 
07 IPTYPE 
08—OB IPMSGID 
OC—OF IPTRGCLS 
0C-O0D IPAUDIT 
OC {PAUDIT1 
Lees “Gee 
ode 
Sadea: “8 
eed: mate 
eae eee 
ie ee 
eee 11 
0D IPAUDIT2 
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IPALL Quiesce, resume, and sever all 
IPQUSCE Connect in quiesce mode 
IPPRTY Priority message, reply required 
IPNORPY One-way protocol 

IPCPENTY Entry from CP 

IPFGMID Message ID specified 

IPFGPID Path ID specified 

IPFGMCL Message class specified 
External interrupt code 

Message ID 


Target class 
Audit trail as follows: 
Audit trail byte 1 


IPADRPLE Reply too !ong for buffer 
IPADSNPX Protection exception on send buffer 
IPADSNAX Address exception on send buffer 
IPADANPX Protection exception on answer buffer 
IPADANAX Address exception on answer buffer 
IPADRJCT Message was rejected 

Zero 
Audit trail byte 2 
IPADRCPX Protection exception on receive buffer 
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OE —0F 
10-13 
14-15 
16-17 
18—1B 
1C—1F 


4 


"LIER' 


00 — 03 
04-07 


08—OF 
10-13 
14-17 
18-1F 


4 


00-03 
04-05 
06-13 
14-17 


18—-1B 


Last four 


char of 
module 
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a eee IPADRCAX Address exception on receive buffer 


meal ds woveet IPADRPPX Protection exception on reply buffer 
are Merrereere IPADRPAX Address exception on reply buffer 
poe ree IPADSVRD Path was severed 
saree: eka Zero 
Zero 
IPBFADR1 Address of buffer 1 
Zero 
IPBFLN1 Length of buffer 1 


IPSRCCLS 
VEIB Address 


Source class 


LIER Entry: Logical interface error, ccs = > vscs 


8 10 14 18 1F 
LU name OTITAB 
with 


logic err ADDR 


Displacement: 


Character ‘LIER’ 


Last four characters of module making trace entry. First four charac- 
ters are always DTIP. 


Logical unit name of device with logical interface error. 

Address of DTITAB 

Address of DTIWEB that was input to module making trace entry. 
Zero 


SCNT Entry: Request to sever connection, ccs = > vscs 


6 14 18 1c 10 1F 


Address 


Reason 


Code 


Displacement: 


Characters 'SCNT’ 

ID of path that was severed 

Zero 

Address of Terminal Anchor Block (TAB) or Service Application Block 
(SAB) 

Zero 
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1C 


1D—1F 


Reason code 


VSCS not enabled by CP 

Maximum logical unit limit exceeded 

No VSCS global CONNECT accepted 

VTAM service machine (VSM) not enabled 

Duplicate logical unit name found on VSM RDEVBLOK chain 
This path ID is currently in use 

VTAM service machine was previously connected 

Message limit exceeded 

VTAM service machine global path severed 

Zero 


OnN DMA WD — 


ce) 


SEVR Entry: Connection severed, vscS = > ccs or CCS to = > vSCS 


0 4 


6 14 18 1F 


Address 


Displacement: 


00-03 
04—05 
06-13 
14-17 
18—1F 


Characters ‘SEVR’ 

ID of path that was severed 
Zero 

Address of TAB or SAB 
Zero 


vm VSCS Dispatcher Trace Record Format 
When the dispatcher trace option is active, vSCS traces all traffic through the vscs 
state managers (DTIPSTAM and OTIVSTAM). This trace can be limited to one or 
several logical units by starting the vscs dispatcher trace for selected logical units. 
Use the vSCS TRACEON (DISP command to start the vScs dispatcher trace. See VTAM 
Operation for additional information. The dispatcher trace produces two types of 
record formats: 


Logical unit-related for traffic associated with logical units 
Global for traffic not associated with a logical unit. 


The following examples show the format of records created for each event. 
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vm Format for a Dispatcher Trace Entry for a Logical Unit 
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LBCSTATE 


Last four characters of module name 


Displacement: 


00 


01 


02 


03 


04 


Header ID 


LBCSTTUS 
DTITAB address 


DTIWEB address 


PLBFSSMF | PLBLFLG1 


WEBFUN WEBMOD 


PLBFLG] 


D No module ID found or address of module is zero 
P Presentation Services dispatcher 

V VTAM Services dispatcher 

LBCSTTUS and current task running 


WEBFUN 


WEBMODE 


WEBVSRPS 


01 
02 


LBCSIP 1 = busy,O = not busy 

Zero 

Presentation Services task running 
VTAM Services task running 

Unknown task running 

WEB function code from input WEB. This is explained in 
“VMWEB Function Codes” on page 215. 

WEB mode from input WEB 


00 Console 

01 CMS 

02 Full-screen 

04 Internal 

VTAM Services response to SEND request from Presen- 
tation Services 


03 
04 
05 
06 
07 
08 
OC 
OD 
OE 
OF 
10 


WEBVSOPC Operation check 

WEBVSLFU — Unconditional logoff 

WEBVSERR _ Unrecoverable I/O error 
WEBVSBSY _ Printer busy 

WEBVSIRQ Intervention required 
WEBVSNAV _ Printer not available 
WEBTWXER_ TWX read error, sense code 0827 
WEBVSAOK Successful completion 
WEBVSVER  Unrecoverable internal error 
WEBVSPSL Presentation space integrity lost 
WEBVSCNL SEND canceled by cancel key 
WEBVSCC1 Reflect attention, CC1 on SIO 
WEBVSECU Equipment check and unit specify 
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05 — 07 
08 


09—-0B 
0C 


OD 


14 


12 

13 

14 

15 
DTITAB 
PLBDFLG1 


DTIWEB 


page 214.) 
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WEBVSDCU 


WEBVSEC 


WEBVSCRJ 


WEBVSDC 
WEBVSCC 


Data check and unit specify 


Equipment check 
Command reject 
Data check 

Command check 


Address of TAB passed 
Device manager flags 


PLBDASS 
PLBDNEW 


PLBNOVCK 


PLBDCH 


PLBDXTDS 
PLBDXCLR 
PLBDXHLI 

PLBDATTN 


PLBDMASK 


Display has alternate size 

Bit is on for a 3278, bit is off for a 3277 
Do not validity check data 

Display has new color or highlight func- 
tions, no B‘000' 

Extended data stream available 
Extended color available 

Extended highlight available 

Printer attention 

Password mask 


Address of current WEB 
LBCSTATE from PLB (See “vm LBCSTATE Values for PLBINxxx” on 


LBCINT 


LBCFSSMF 
LBCFSAV 
LACESII 


LBCCOPY 
LBCNAL 
LBCHOLD 
LBCM10 
LBCM5S0 
LBCCMSD 


Internal mode if on (on=1). If LBCINT is 
on, see ‘vm LBCSTATE Values for 
PLBINxxx” on page 214. If LBCINT is off, 
the following values apply: 

Full-screen support mode flags 

Screen available 


Full-screen input inhibited: 


B'00’ CP (Console) mode 

B‘01' Virtual machine mode state 
between ATTN and READ, 
QUEUE CP messages. 

B‘10’ Virtual machine mode QUEUE CP 
messages. 

B'11’ Virtual machine mode available 
for switch. 


Copy mode: on=1 

NAL flag: on=1 

Holding flag: on=B'11’ 

‘More 10 flag: on=1 

‘More’ 50 flag: on=1 

Screen written with a CMS DIAGNOSE: 
on=1 

No more holding state 


Full-screen support mode flags 


PLBFPA1 
PLBFSRFC 
PLBFSAFC 
PLBFCNMP 
PLBFVSIP 
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PA1 key received switch mode 

Mode switch required (FSSM to Console) 
Switch available (FSSM to Console) 
Console message pending 

VTAM Services SEND in progress 


179 


OE PLBLFLG1 


OF PLBFLG1 


10 PLBPRLBC 
11 PLBOFLGT1 


12-13 PLBNOM 
12 PLBNFLG1 


13 PLBNFLG2 
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PLBFCLGF 
PLBFCMRR 


PLBCMSEW 
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Conditional logoff received 


CP message pending, response required 
Screen has just been erased 


VTAM Services logoff flags for Presentation Services 


PLBLVS 


PLBLGFC 
PLBLGFU 


PLBLERR 
PLBLLERR 


PLBLVERR 


PLBLSEVR 
PLBLNSTR 
PLB flags 
PLBLGO 
PLBINAR 
PLBLFLNP 
PLBCONCT 
PLBCNCTI 
PLBINREC 
PLBPRMPT 
PLBSDIAL 


VTAM Services logoff received, bypass 
logo 
WEBINLGF sent to CCS conditional logoff 


WEBINLGF sent to CCS unconditional 
logoff 
WEBINERR sent to CCS for hard error 


WEBINLER sent to CCS for interface 
error 


WEBINVER sent to CCS for internal logic 
error 
CP CCS SEVER received, must sever 


No storage indicator in logoff 


Logo mode logical unit 

APL/TEXT starting in input area 

Logon from logo not permitted 

Current count incremented 

lUCV CONNECT issued 

Input received during purge processing 
Usability prompt message flag 
SNA-dialed !ogical unit 


Previous logical unit LBCSTATE 
Output manager flags 


PLBSDIAG 
PLBPSMSG 
PLBOSRIP 
PLBOKLOK 
PLBOKPMI 
PLBOSWRT 
PLBOCRRQ 


PLBOEXRQ 


CMS DIAGNOSE on screen 

Priority message on screen 

SEND retry in progress 

Keyboard locked 

Keyboard printer mask input area sent 
CMS WRITE active (no input received) 


Carriage return required before SEND on 
hardcopy terminal 

‘! required before SEND on hardcopy ter- 
minal 


Notify output manager 


NOM flag 1 
PLBCEND 
PLBRDTX 
PLBSAC 
PLBCLROA 
PLBCLRIA 
PLBRING 


PLBUNLK 
NOM flag 2 


Command end (read) 

The redisplay timer has expired 
Status area change required 
Clear output area 

Clear input area 

Ring the alarm 

Zero 

Unlock keyboard 
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14 


15 
15 


16 


17 


18 


19 


1A 


~111 1111 
PLBEDIT 


PLBIATTN 
PLBIAFLG 


- 1111 
VLBFLG1 
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PLBRDPND __—‘ Redisplay pending 
Zero 
Editing flags 
PLBNCONV  User-translated output data 
Zero 
PLBHIEKO Highlight input redisplay 
PLBEDPTI Do not print or do not display 
PLBNOEKO Donot redisplay input on next output line 
PLBEDCUP Convert to upper case 


Input manager attention handling 
Input manager attention handling flags 


PLBMATITN Multiple attention received 
PLBSATTN Single attention received 
PLBIPAT Attention received in ‘MORE’ 
Zero 
VLB 
LBCVSST VTAM Services state: 0 = Normal, 
1 = Termination 
VLB flags 
VLBBSPBB _ Bracket-state pending begin bracket 
VLBBSPEB __ Bracket-state pending end bracket 
VLBBSINB Bracket-state in bracket 
VLBSR Application SEND or RECEIVE state: 
1 = SEND state,0 = RECEIVE state 
Zero 
VLB flag 1 
VLBIOTR Inbound data received since last SEND 
VLBCLSD CLSDST not required 
VLBPCS Purging chain state 
VLBSIGNL Signal sent 
VLBCHGD Change direction required 
VLBRETR Retry RECEIVE request 
VLBRETS Retry SEND request 
Zero 
VLB flag 2 
VLBRPLB RPL in use 
VLBCLPND  VTAM CLSDST pending 
Zero 
VLBBUSY Printer busy 
VLBNAV Printer not available 
VLBOPCK Operation check occurred 
VLBWAIT Waiting for data or LUSTAT 


Special SEND indicator 


VLBCLR Clear required 

VLBSDT Start data traffic (SDT) required 
VLBCANC Cance! required 

VLBSIGRQ Signal required 
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VLBLRCD 
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Zero 


Logoff reason codes 


VLBVTLO 
VLBVRYI 
VLBHLTQ 
VLBHLTC 
VLBIOE 
VLBINERR 


VTAM LOGOFF 

VARY INACTIVE 

HALT QUICK 

HALT CANCEL 
Unrecoverable I/O error 
Internal error 

Zero 


1C—1F Last four characters of module ID 


vm Format for a Dispatcher Trace Entry for a Global Connection 
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00 {Header ID 


Task/Busy SABIQECB 


04 Address passed 
08 DTIWEB address 


QC SABFLG1 SABRFLG1 
: 
18 WEBRSVSA 
1C Last four characters of module name 


Displacement: 


0 


02-03 
04-07 
08 — 0B 
0C 


Trace record header ID 


D No module ID found or module address is zero 
P Presentation Services dispatcher 

V VTAM Services dispatcher 

LBCSTTUS and current task running 

Address of SAB included 


SABIQECB 
DTIWEB 
SABFLGS1 


Zero 


Presentation Services task running 
VTAM Services task running 
Unknown task running 


First two byt 


es of SABIQECB event control block (ECB) 


Address passed 
Address of WEB 


SABDMPNO 
SABVSCSV 
SABDUIP 
SABCSOPN 


Do not take a dump 

VSCS running in VTAM machine 
Dump in progress 

VSIUCV open 
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0D 


OE 


OF 


10 


11 


12 


13 


14 


. lili 
SABRFLG1 


- 1ill 
WEBFUN 


WEBMODE 


WEBCHAR 


WEBEDIT 
BELT eas 
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SABBUFDQ 


SABGETFL 


SABNEWLG 
SABVEIBS 


DTISGETB dequeue type: FIFO=1, 
LIFO=0 

GETMAIN failed 

Zero 

New logo format allowed 

VEIB shortage has occurred 

Zero 


Abend-in-progress flags 


SABVABIP 
SABPABIP 
SABUABIP 


VTAM Services abend in progress 
Presentation Services abend in progress 
Utility Services abend in progress 

Zero 


Global termination flags 


SABTETPE 
SABTESIQ 
SABTETIP 
SABTEATP 
SABINVQT 


TPEND in progress 

Termination scheduled by DTIIQUIT 
Termination in progress 

Abnormal termination in progress 
Invalid termination request detected 
Zero 


Global recovery flags 


SABVSCTL 
SABPSCTL 
SABTICTL 

SABCXCTL 


VTAM Services task in control 
Presentation Services task in control 
Timer exit in control 

Communications Services exit in control 
Zero 


WEB function code. This is explained in “vm WEB Func- 
tion Codes” on page 215. 


Mode: 


00 Console 


01 CMS 


02 Full-screen 


04 = =Internal 


Character set (set by CCS for Console and CMS modes) 


00 EBCDIC character set 
01 APL character set 

02 TEXT character set 
Editing characteristics 


WEBHIEKO 
WEBEDPTI 
WEBNOEKO 
WEBEDCUP 


WEBRSV1 


WEBCONMD 


WEBLED 
WEBANFSW 


Zero 

Highlight input display 

Do not print or do not display 

Do not redisplay input on next output line 
Convert to upper case 


Zero 
Request for display in conmode 3270 
Limited edit diagnose 


Allow any full-screen write; first full- 
screen write after reset. 
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a re WEBDIAL SNA-dialed logical unit 
ee WEBNOMOR CMS ERASE or WRITE NO ‘MORE’ 
requested 
iad. inde WEBPRMPT WEBDATA contains pre-logon message 
sds “sedet l WEBPASPA _ Pass PA1 (FSSM) as data to application 
15 WEBCPFLG-_ CCS status flags for VSCS 
Teak wdcnave WEBCPNCR __ Do not imbed carriage return in data 
stream (on hardcopy terminal) 
a ee ee WEBCPPRI _ Priority flag 
wile  eiwiace WEBCPALM | Ring the alarm 
Sails “etnies WEBSAHLD — Holding 
es aera WEBCPMDE CP-generated bit = 1 
Salle codes WEBSAMOR_ ‘More’ VM-generated bit = 0 
ae ee WEBCPHLW Highlight write requested 
Mec WEBCPRSP _ Indicates CCS response 
Fa ae WEBSARSP _ Indicates VSCS response 
ath WEBCPRRR_ CCS request, requires response 
Stee, -acciles WEBSARRR_ VSCS request, requires response 
ssficd it weuties 1 WEBCPRNR- CCS request, requires no response 


Sten exis 1 WEBSARNR_ VSCS request, requires no response 
16-17 WEBLINE Line number for CMS WEBCMWRT 


16 WEBLAID Logical attention identifier 
17 WEBNLLOS Number of lines left on screen 
18—19 WEBCURSR_ Cursor position may be a relative address or a buffer 
address 
1A WEBTABCH _ Tab (not DTITAB) character 
1B WEBRSVSA _ Reserved for VSCS use 
Ties ss ea WEBCPRDS _ DTIWEB is a redisplay DTIWEB 
eel sts candace WEBNOVCK _ Do not validity check data 
Les oe WEBATTNW Attention write (VSCS only) yes = 1 
nore es eee Zero 
a coe WEBCHDIR Change direction required 
ancl. WEBMASKW_. Write inhibit mask 
etwie wakes ] Zero 


1C—1F Last four characters of module ID (or entry address) 


vu VSCS VTAM Exit Trace Record Formats 
If you are running the default vScs trace (VSCS V3R1.2 and later) and you have acti- 
vated the trace with an operator command, or by starting vscs with the VTAM exit 
trace active, VSCS traces all inbound traffic through the VSCS VTAM exits. You can 
limit the vTAM exit trace to a selected set of logical units by starting VSCS VTAM trace 
for those logical units. 


You can produce the vTAM exit trace in two formats: 


Normal trace record if the request is a valid vscs logical unit 
Data trace record if the request or response was invalid, or if the data traced is 
different from the normal VTAM exit trace record. 
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Below is the format for the records created for each event. 


vm VSCS VTAM Exit Trace Entries 


00 


04 


08 


OC 


10 


14 


18 


1¢c 


Module ID 
RTN CODE DTITAB address 


RPL REQ RPL address 


alal- 


RPLFDBK RPLSSNSI or RPLUSNSI 


LBCSTATE 


SOURCE NAU 


PLBLFLG1 | PLBNFLG1 


VLBSWAP 


VLBLRCD VXIT data 


PLBFSSMF 


PLBOFLG1 | LBCSTATE 


Displacement: 


00 V=VTAM Services 

01-03 Three-character module ID DTIVxxxx 
04 Return code from module 

05—07 TAB address for current request 

08 RPL request code 

OS-—0OB RPL address 

OC—OD RPLFDB2 


OE — OF 


10-11 Source network address 


12 
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DTIVCLSX 
DTIVDFAX 
OTIVLOGX 
DTIVNSEX 
DTIVOPNX 
DTIVRECX 
DTIVRESX 
DTIVRLQX 
DTIVSCIX 
DTIVSNDX 


RPLUSNSI (user sense) or RPLSSNSI (system sense) 


LBCSTATE from PLB (See “vm LBCSTATE Values for PLBINxxx” on 
page 214.) 
| ese LBCINT Internal mode if on (on=1). If LBCINT is 
on, see “vm LBCSTATE Values for 
PLBINxxx" on page 214. If LBCINT is off, 
the following values apply: 
et) Nig: terete LBCFSSMF _ Full-screen support mode flags 
leg: a8. LBCFSAV Screen available 
a oes LBCFSII Full-screen input inhibited: 
B‘'00’ CP (Console) MODE 
B'01' Virtual machine mode state 
between ATTN and READ, 
QUEUE CP messages. 
B‘'10’ = Virtual machine mode QUEUE CP 
messages. 
B'll’ Virtual machine mode available 
for switch. 
ed. Gidea LBCCOPY Copy mode: on=1 
Bieber «fl adobe LBCNAL NAL flag: on=1 
reer, ails LBCHOLD Holding flag: on=B‘11’ 
eon at Wes LBCM10 ‘More’ 10 flag: on=1 
sie hte LBCM50 ‘More’ 50 flag: on=1 
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13 


14 


15 


16 


17 
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Screen written with a CMS DIAGNOSE: 
ON=1 


No more holding state 


Full-screen support mode flags 


PLBFPA1 
PLBFSRFC 
PLBFSAFC 
PLBFCNMP 
PLBFVSIP 
PLBFCLGF 
PLBFCMRR 


PLBCMSEW 


PA1 key received switch mode 

Mode switch required (FSSM to Console) 
Switch available (FSSM to Console) 
Console message pending 

VTAM Services SEND in progress 
Conditional logoff received 

CP message pending, response required 
Screen just cleared 


VTAM Services logoff flags for Presentation Services 


PLBLVS 


PLBLGFC 
PLBLGFU 


PLBLERR 
PLBLLERR 


PLBLVERR 


PLBLSEVR 
PLBLNSTR 
NOM flag 1 
PLBCEND 
PLBRDTX 
PLBSAC 
PLBCLROA 
PLBCLRIA 
PLBRING 


PLBUNLK 


VTAM Services logoff received, bypass 
logo 
WEBINLGF sent to CCS conditional logoff 


WEBINLGF sent to CCS unconditional 
logoff 
WEBINERR sent to CCS for hard error 


WEBINLER sent to CCS for interface 
error 


WEBINVER sent to CCS for internal logic 
error 
CP CCS SEVER received, must sever 


No storage indicator in logoff 


Command end (read) 

The redisplay timer has expired 
Status area change required 
Clear output area 

Clear input area 

Ring the alarm 

Zero 

Unlock keyboard 


Output manager flags 


PLBSDIAG 
PLBPSMSG 
PLBOSRIP 
PLBOKLOK 
PLBOKPMI 
PLBOSWRT 
PLBOCRRQ 


PLBOEXRQ 


From VLB 
LBCVSST 


CMS DIAGNOSE on screen 

Priority message on screen 

SEND retry in progress 

Keyboard locked 

Keyboard printer mask input area sent 
CMS WRITE active (no input received) 


Carriage return required before SEND 
(on hardcopy terminal) 

‘!’ required before SEND (on hardcopy 
terminal) 


VTAM Services state: 0 = Normal, 
1 = Termination 
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18 


19 


1A 


1B 


1C 


VLBFLG 


»-. 111] 
VLBFLG1 


- lili 


VLB flags 


VLBBSPBB 
VLBBSPEB 
VLBBSINB 
VLBSR 


VLB flag 1 
VLBIOTR 


VLBCLSD 


VLBPCS 
VLBSIGNL 
VLBCHGD 
VLBRETR 
VLBRETS 


VLB flag 2 
VLBRPLB 
VLBCLPND 


VLBBUSY 
VLBNAV 
VLBOPCK 
VLBWAIT 


Bracket state-pending begin bracket 
Bracket state-pending end bracket 
Bracket state-in bracket 


Application SEND or RECEIVE state: 
1 = SEND state,0 = RECEIVE state 


Zero 


Inbound data received since last SEND 
indicator 

CLSDST: 0 = required, 1 = not 
required 

Purging chain state 

Signal sent 

Change direction required 

Retry RECEIVE request 

Retry SEND request 

Zero 


RPL in use 

VTAM CLSDST pending 
Zero 

Printer busy 

Printer not available 
Operation check occurred 
Waiting for data or LUSTAT 


Special function flags 


VLBCLR 
VLBSDT 
VLBCANC 
VLBSIGRQ 


Clear required 
SDT required 
Cancel required 
Signal required 
Zero 


Logoff reason codes 


VLBVTLO 
VLBVRY!I 
VLBHLTQ 
VLBHLTC 
VLBIOE 
VLBINERR 


VTAM LOGOFF 

VARY INACTIVE 

HALT QUICK 

HALT CANCEL 
Unrecoverable I/O error 
Internal error 

Zero 


1D—1F VTAM exit-module-dependent data 
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vm VTAM Exit-Module-Dependent Data 


DTIVCLSX 
1-3 WEB address or zero 
DTIVDFAX 
1 WEBFUN value. This is explained in “vm WEB Function Codes” on 
page 215. 
2 Zero 
3 Module flow indicator 
Vie ae tae DTIVPURG called 
2 XX XXXX Space reserved for module flow indicator 
1 SEND issued support command 
2 SEND issued unsupported command 
3 DTIWBLD issued 
4 DTISCHED issued 
DTIVLOGX 
1 WEBFUN value. This is explained in “vw WEB Function Codes” on 
page 215. 
2 SABTFLG1 field 
3 Module flow indicator 
| ee Asynchronous CLSDST issued 
Fs Synchronous CLSDST issued 
2 XX XXXX Space reserved for module flow indicator 
1 Start NIB build process 
2 INQUIRE TERMS issued 
3 Started building session parameters 
4 INQUIRE SESSPARM issued 
5 DTIVTRMI called 
6 Attempting OPNDST 
7 Invalid device or invalid bind format 
8 Unsupported auxiliary device or unsupported screen 
size 
DTIVNSEX 
1-3 Bytes 0-2 of input data field 
DTIVOPNX 
1 WEBFUN value. This is explained in “vM WEB Function Codes” on 
page 215. 
2 Zero 
3 Module flow indicator 
Pete. katate Check failed 
XX XXXX Space reserved for module flow indicator 
DTIWBLD issued 
2 DTISKED issued 
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DTIVRECX 

1 WEBFUN value. This is explained in ‘vm WEB Function Codes” on 
page 215. 

2 Return code from CHECK macro 

3 Module flow indicator 
rae Zero 
. XX XXXX Space reserved for module flow indicator 
1 Major (non-recoverable) error detected 
2 Asynchronous device end received 
3 Failure sending exception response (to exception 

request) 
4 SEND failure trying to issue a normal response 
5 DTIVRECM failure 
6 DTINQ failure 
7 DTIWBLD failure 
8 DTIDQ failure 
9 Chaining accumulator error 
A Error attempting to send chain format error response 
B Error attempting to send RU length error response 
C In purging chain state 
D First in chain received 
E Middle of chain received 
F End of chain received 
10 VTAM chain indicator error 
11 LUSTAT =No input mechanism 
12 TWX read error 
13 Null RU with CHANGE DIRECTION processed 
14 Entry invalid — TAB invalid or CID mismatch 
15 Entry ignored — logical unit undergoing CLSDST 
16 DTIVLOFF called for logical unit 
17 Null RU without CHANGE DIRECTION processed 
DTIVRESX 

1 WEBVSRPS 
X'15! WEBVSCC Command check 
X'14! WEBVSDC Data check 
x13" WEBVSCRJ Command reject 
X'12' WEBVSEC Equipment check 
xT? WEBVSDCU__— Data check and unit specify 
X'10! WEBVSECU Equipment check and unit specify 
X'OF! WEBVSCC1_ Reflect attention, CC1 on SIO 
X'0OE' WEBVSCNL SEND canceled - CANCEL key 
X'OD' WEBVSPSL Presentation space integrity lost 
X'OC! WEBVSVER  Unrecoverable internal error 
X'08' WEBVSAOK — Successful completion 
X'07' WEBTWXER TWX read error sense X'0827' 
X'06' WEBVSNAV _ Printer not available 
X'05' WEBVSIRQ _ Intervention required 
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DTIVRLQX 


1-3 


DTIVSCIX 


1 
2 
3 


DTIVSNDX 


1 


X'04! 
X'03! 
X'02! 
X'01! 
VLBERCVY 


WEBVSBSY 


WEBVSERR 
WEBVSLFU 
WEBVSOPC 


VLBERCLR 
VLBERBRK 
VLBERSDT 
VLBERSIG 

VLBERCNL 
VLBERCDR 
VLBERPSL 
VLBERHRD 


Module flow indicator 


0 oXX XXXX 
01 
02 
03 
04 
05 
06 
07 
08 
14 
15 


zero 


Request code 
UNBIND type 


zero 


WEBVSRPS 
X15! 
X14! 
X13" 
X12! 
X11 
X10 
X'OF' 
X'0E! 
X'0D' 


Reserved 
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Printer busy 


Unrecoverable |/O error 
Unconditional logoff 
Operation check 


Clear requested 

Bracket error occurred 

Start Data Traffic required 
Signal required 

Change received 

Change direction required 
Presentation space integrity lost 
Hard error occurred 


Module flow indicator 

Purge logical unit 

SEND requested 

Error recovery pending 

Error recovery in progress, request ignored 
Error element not found 

Unrecoverable error occurred 

Dequeue failure 

Logical unit being purged 

Invalid entry — TAB invalid or CID mismatch 
Entry ignored — logical unit undergoing CLSDST 


WEBVSCC 
WEBVSDC 
WEBVSCRJ 
WEBVSEC 
WEBVSDCU 
WEBVSECU 
WEBVSCC1 
WEBVSCNL 
WEBVSPSL 


Command check 

Data check 

Command reject 

Equipment check 

Data check and unit specify 
Equipment check and unit specify 
Reflect attention, CC1 on SIO 
SEND canceled - CANCEL key 
Presentation space integrity lost 
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Entry ignored — logical unit undergoing CLSDST 


Unrecoverable internal error 


Successful completion 

TWX read error sense X'0827' 
Printer not available 
Intervention required 

Printer busy 

Unrecoverable I/O error 
Unconditional logoff 
Operation check 


Clear requested 

Bracket error occurred 
Start Data Traffic required 
Signal required 

Change received 

Change direction required 


Presentation space integrity lost 


Hard error occurred 


X'0C' WEBVSVER 
X'08' WEBVSAOK 
X'07' WEBTWXER 
X'06' WEBVSNAV 
X'05' WEBVSIRQ 
X'04' WEBVSBSY 
X'03' WEBVSERR 
X'02' WEBVSLFU 
X'01' WEBVSOPC 
2 VLBERCVY 

ead eee VLBERCLR 
iy VLBERBRK 
wade VLBERSDT 

Sake weet VLBERSIG 
eae ere VLBERCNL 

ne ee VLBERCDR 

ere VLBERPSL 

siete aearanl VLBERHRD 

3 Module flow indicator 

or DTIVPURG called 
elisk DTIVLOFF called 
weds 

sek 
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vm Format for VTAM Exit Data Trace Entries 
These trace records are created when: 


192 VTAM Diagnosis 


¢ Minimum data is available 
¢ VTAM issues an invalid request to vscs 
* VTAM Calls fail validity checks. 


DTIVCLSX 


00 


04 


08 


OC 


10 


1C 


V C L S 
RPL REQ RPL address 


DTITAB address 


OTIWEB address or zero 


Displacement: 


00 — 03 
04 

05 —07 
08 —0B 
OC — OF 
10-—1B 
1C 

1D—1F 


Characters ‘VCLS' 

RPL request code 

RPL address 

Invalid TAB address 

RPL CID 

Zero 

X'FF' to indicate data trace entry 
WEB address or zero 


DTIVDFAX 


00 


04 


08 


16 


10 


14 


18 


1C 


= [rw [ie 


Mod. flow 


Displacement: 


00-03 
04-07 
08— 0B 
0C —OF 
10-13 
14-17 


Characters ‘VDFA’ 
Input ACB address 
Input CID 

Input TAB address 
Zero 

Input RPL address 
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18-1B Zero 
1C X'FF' to indicate data trace entry 
1D WEBFUN value. This is explained in “VM WEB Function Codes” on 
page 215. 
1E Zero 
1F Module flow indicator 
Mesos sears DTIVPURG called 
»»XX XXXX Module flow indicator 
1 SEND issued supported command 
2 SEND issued unsupported command 
3 DTIWBLD issued 
4 DTISCHED issued 
DTIVLOGX 
. 
; 
: 
: 
10 Length of logon message 
14 LU name 


Displacement: 


00-03 Characters ‘VLOG’ 
04—07 Input ACB address 
08—0OB Address of logical unit name 


OC—OF Zero 


10-13 Length of logon message 
14—1B Logical unit name 


1C X'FF' to indicate data trace entry 
1D WEBFUN value. This is explained in “VM WEB Function Codes” on 
page 215. 
= SABTFLG1 field 
1F Module flow indicator 
Dea’ apatite Asynchronous CLSDST issued 
wales Synchronous CLSDST issued 
5a KKK Module flow indicators 
| Start NIB build process 
2 INQUIRE TERMS issued 
3 Started building session parameters 
4 INQUIRE SESSPARM issued 
5 DTIVITRMI called 
6 Attempting OPNDST 
ri Invalid device or invalid BIND format 
8 Unsupported auxiliary device or unsupported screen size 
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DTIVLOSX 


V L 0 S 


Displacement: 


00-03 Characters ‘VLOS' 
04—07 Input ACB address 
08—OB Input CID 
OC—OF Input NIB user field 
10-13 Reason code 
0C Contact lost 
14 Unconditional logoff 
20 Conditional logoff 
24 Buffer limit 
14-17 TAB address or zeros 
18—1B WEB address or zeros 


00 


04 


08 


eC 


10 


14 


18 


1c 


10 X'FF' to indicate data trace entry 
1D-—1E Zero 
1F Module flow indicator 


1... .... | DTIVPURG called 

« oXX XXXX Module flow indicator 
1 DTIWBLD issued 

2 DTISKED issued 


DTIVNSEX 


ee 


00 


04 


08 


ec 


10 


14 


18 


1C 


194 VTAM Diagnosis LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


“Restricted Materials of IBM" 
Licensed Materials — Property of IBM 


Displacement: 


00-03 Characters 'VNSE' 

04-07 Input ACB address 

08—0OB Input CID 

OC—OF Input TAB address 

10-13 Zero 

14-17 Input RPL address 

18 RPL request code 

19-—1B Input RPL address 

1C X'FF' to indicate data trace entry 
1D—1F First three bytes of input data field 


DTIVOPNX 


[ve 


Displacement: 


00 


04 


08 


QC 


1C 


00-03 Characters ‘VOPN’ 
04 RPL request code 
05-07 Input RPL address 
08—O0OB Invalid TAB address 


OC-—1B Zero 
1C X'FF' to indicate data trace entry 
1D WEBFUN. This is explained in “vm WEB Function Codes” on page 215. 
1E Zero 
1F Module flow indicator 

Witiean Alas Check failed 

2 eXX XXXX Module flow indicator 

1 DTIWBLD issued 

2 DTISKED issued 
DTIVRECX 
ee 
; 
. 
: 
14 Zero 
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Displacement: 


00-03 
04 
05-07 
08 — 0B 
0C — OF 
10-13 
14-1B 
iC 
1D 
1E 
1F 


Characters 'VREC' 
RPL request code 
Input RPL address 
Invalid TAB address 
VLB address 
Input WEB address 
Zero 
X'FF' to indicate data trace entry 
WEBFUN. This is explained in “vm WEB Function Codes” on page 215. 
Return code from CHECK macro 
Module flow indicator 
Dece tavhats Zero 
2 XX XXXX Module flow indicator 
1 Major (non-recoverable) error detected 
2 Asynchronous device end received 
3. Failure sending exception response (to exception 
request) 
SEND failure trying to issue a normal response 
DTIVRECM failure 
DTINQ failure 
DTIWBLD failure 
DTIDQ failure 
Chaining accumulator error 
Error attempting to send chain format error response 
Error attempting to send RU length error response 
In purging chain state 
First in chain received 
Middle of chain received 
End of chain received 
10 VTAM chain indicator error 
11. LUSTAT=No input mechanism 
12 TWX read error 
13. Null RU with CHANGE DIRECTION processed 
14 Invalid entry — TAB invalid or CID mismatch 
15 Entry ignored — logical unit undergoing CLSDST 
16 DTIVLOFF called for logical unit 
17. Null RU without CHANGE DIRECTION processed 


TNTMOVODYrYWAOCOAOAN DN Ff 
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DTIVRESX 


Note: This trace record is created only when exception response is used. 


REQCODE 


ODTITAB 


OTIVLB 


DTIWEB 


RESE 


X'FF' | RESERVED RESERVED | MOD FLOW 


Displacement: 


Characters ‘VRES’ 
RPL request code 


00-03 
04 

05-07 
08—0B 
0C — OF 
10-13 
14-17 
Ke 

1D-1E 
1F 


RPL address 
TAB address 
VLB address 
WEB address 
Zero 


RPL ADDRESS 


S 


ADDRESS 


ADDRESS 


ADDRESS 


RVEO 


X'FF' to indicate data trace entry 


Zero 
Module flow i 


» @XX XXXX 
01 
02 
03 
04 
05 
06 
07 
08 
14 
15 
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ndicator 

Reserved 

Module flow indicator 

Purge logical unit 

SEND requested 

Error recovery pending 

Error recovery in progress, request ignored 
Error element not found 

Unrecoverable error occurred 

Dequeue failure 

Logical unit being purged 

Invalid entry — TAB invalid or CID mismatch 


Entry ignored — logical unit undergoing CLSDST 
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DTIVRLQX 


00 


04 


ec 


14 


18 


1c 


a 


Displacement: 


00-03 Characters ‘VRLQ’ 

04—0B ACB name 

0C-—13 Logical unit name 

14—17 TAB address 

18-18 Zero 

1c X'FF' to indicate data trace entry 

1D Return code 

1E-—1F Zero 

DTIVSCIX 

: 
: 
08 CID (not used) 

: 
: 
; 
© [ee _ [reve [eine [toe 


Displacement: 


00-03 
04-07 
08— OB 
OC —1F 
10-13 
14-17 
18 
19—1B 
1C 
1D 
1E 
1F 


Characters ‘VSCI’ 
ACB address 

CID (not used) 
DTITAB address 
Zero 

RPL address 

RPL request 

RPL address 
X'FF' to indicate data trace entry 
Request code 
Unbind type 

Zero 
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DTIVSIMX 


60 


04 


08 


0c 


10 


18 


ic 


Ces 


Displacement: 
00-03 Characters ‘VSIM’ 


04 


RPL request code 


05-07 input RPL address 
08—0OB RPL feedback word 
O0C—OF RPLFDBK2 

10-17 Logical unit name 
18-—1B OTITAB address 


1C 


X'FF' to indicate data trace entry 


1D-—1F Return code from CHECK macro 


DTIVSEND 


Note: This trace record is created only when exception response is used. 


S E N 
OTITAB ADDRESS 


DTIWEB ADDRESS 


XMTFLG1 XMTFLG2 MODE/TYPE} LBCSTATE 


PLBFSSMF | PLBLFLG1 | PLBNFLG1 | PLBOFLG1 
VLBLRCD VLBERFLG VLBERSQ1 


VLBSWAP 


X'FF* CALLER'S RETURN ADDRESS 


Displacement: 
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00-03 Characters ‘VSEN' 
04-07 DTITAB address 
08—OB DTIWEB address (DTICMT, DTIWEB, DTIXMT) 


oC XMTFLG1 — Transmit flag 1 
Lads 4633 XMTCD Change direction required (for start/stop) 
hie. Geka XMTRSHOW  Redisplay in DTIXMT buffer 
Alle whane'e XMTPMSG Priority message on screen 
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Ped Gene XMTDIAG CMS DIAGNOSE on screen 
Pom eee XMTLRO Logo RU 
nc ee XMTATTN Attention write (VSCS only) yes = 1 
a2 Te XMTINPT Input expected from logical unit 
eae. eee l XMTPWMSK_ Password mask 
OD XMTFLG2 — Transmit flag 2 
Visedar beers XMTVDATR ~~ DTIVDATR called 
lone: auaser XMTERCMT~ ODTIXMT is really a DTICMT 
Fo mre XMTERERR _ Error retry necessary 
oe eee XMTERPSL Presentation space integrity lost 
ye Thea XMTLMPEO LMPEO SEND initiated 
ee ery ee Zero 
OE MODE or TYPE of request 
B Busy 
C Control command 
D Definite response 
E Exception response 
P Logical unit purged 
X Recovery request 
W_ Logical unit waiting 
OF LBCSTATE from PLB (See “vm LBCSTATE Values for PLBINxxx” on 
page 214.) 
Weighs. Baas LBCINT Internal mode if on (on=1). If LBCINT is 
on, see “vm LBCSTATE Values for 
PLBINxxx” on page 214. If LBCINT is off, 
the following values apply: 
wl Mir. ace LBCFSSMF _ Full-screen support mode flags 
cee LBCFSAV Screen available 
re eae ae LBCFSII Full-screen input inhibited: 
B‘00’ CP (Console) mode 
B'01' Virtual machine mode state 
between ATTN and READ, 
QUEUE CP messages. 
B'10' Virtual machine mode queue CP 
messages. 
B11 Virtual machine mode available 
for switch. 
Br od acs LBCCOPY Copy mode: on=1 
do lees LBCNAL NAL flag: on=1 
reer Ol Oe LBCHOLD Holding flag: on=B'11' 
ae ae LBCM10 ‘More’ 10 flag: on=1 
Sods LBCM50 ‘More’ 50 flag: on=1 
occ ieee 1 LBCCMSD Screen written with a CMS DIAGNOSIS: 
on=1 
woes ae we No more holding state 
10 PLBFSSMF — Full-screen support mode flags 
ThA. uta PLBFPA1 PA1 key received switch mode 
eee PLBFSRFC Mode switch required (FSSM to Console) 
eetlees reat PLBFSAFC Switch available (FSSM to Console) 
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ed tea PLBFCNMP Console message pending 
eee PLBFVSIP VTAM Services SEND in progress 
Paes, eee PLBFCLGF Conditional logoff received 
Sugenar ae Re PLBFCMRR CP message pending, response required 
este reas 1 PLBCMSEW Screen has just been erased 
11 PLBLFLG1 — VTAM Services logoff flags for Presentation Services 
| ree PLBLVS VTAM Services logoff received, bypass 
logo 
pili saa PLBLGFC WEBINLGF sent to CCS conditional logoff 
eee PLBLGFU WEBINLGF sent to CCS unconditional 
logoff 
pe I age PLBLERR WEBINERR sent to CCS for hard error 
i. Dives PLBLLERR  WEBINLER sent to CCS for interface 
error 
sla PLBLVERR  WEBINVER sent to CCS for internal logic 
error 
Be kite Deel PLBLSEVR CP CCS SEVER received, must sever 
goa Bue 1 PLBLNSTR No storage indicator in logoff 
12 PLBNFLG1 — NOM flag 1 
| oe PLBCEND Command end (read) 
oS eee PLBRDTX The redisplay timer has expired 
Ao Pee PLBSAC Status area change required 


RPS) aera PLBCLROA Clear output area 
pccaiee Meri PLBCLRIA Clear input area 
a PLBRING Ring the alarm 
mee Zero 


seueere Janets 1 PLBUNLK Unlock keyboard 
13 PLBOFLG1 — Output manager flags 

Tessanes raters PLBSDIAG CMS DIAGNOSE on screen 

eee PLBPSMSG _s Priority message on screen 

oe ae PLBOSRIP SEND retry in progress 

os eee PLBOKLOK Keyboard locked 
aan eee PLBOKPMI Keyboard printer mask input area sent 
vs ae PLBOSWRT CMS WRITE active (no input received) 
eels PLBOCRRQ - Carriage return required before SEND on 
hardcopy terminal 
Sues. Gusts 1 PLBOEXRQ  '‘!’ required before SEND on hardcopy ter- 
minal 

14 VLBLRCD — Logoff reason codes 

Dee wees VLBVTLO VTAM LOGOFF 

edeey “edaix VLBVRY!I VARY INACTIVE 

vols wax VLBHLTQ HALT QUICK 

avy era VLBHLTC HALT CANCEL 
oes VLBIOE Unrecoverable I/O error 

Se. aces VLBINERR internal error 

ee. ae 11 zero 
15 VLBERFLG — Exception response flags 

Dace saaiee VLBPSHLD DTIXMT pending (PS held) 
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fs ee VLBERPND __ Error recovery pending 


Salar iasots VLBERRIP Error recovery in progress 
Sp aes VLBERPRG Permanent error: purge logical unit 


Sees eer VLBPRGDN Purge complete 
bee VLBERPRM Permanent error 
ise eal VLBEREXT Exit receive control before return 
ica eae 1 VLBRCVNO  Donot reissue RECEIVE SPECIFIC for 
logical unit 

16-17 VLBERSQ1— Sequence number of first error 
18 VLBFLG — VLB flag 

act eee VLBBSPBB __ Bracket-state pending begin bracket 


SMe ge. eas VLBBSPEB __ Bracket-state pending end bracket 
ce bees VLBBSINB Bracket-state in bracket 


el ate VLBSR Application SEND or RECEIVE state: 
1 = SEND state,0 = RECEIVE state 
~ lill Zero 
19 VLBFLG1 — VLB flag 1 
Diack. eke VLBIOTR Inbound data received since last SEND 
lag: cgcsuene VLBCLSD CLSDST not required 
rt eee ae VLBPCS Purging chain state 


Pe Eee VLBSIGNL Signal sent 
UB dagnd VLBCHGD Change direction required 
aecetes 14 Listy VLBRETR Retry RECEIVE request 
erry ce VLBRETS Retry SEND request 


elas vaed Zero 
1A VLBFLG2 — VLB flag 2 
Th crate: -avacors VLBRPLB RPL in use 
heel cane VLBCLPND  VTAM CLSDST pending 
wm dle ei Zero 
pavess shai VLBBUSY Printer busy 
scohevee ales VLBNAV Printer not available 
Suaseee ave des VLBOPCK Operation check occurred 
seaea soir 1 VLBWAIT Waiting for data or LUSTAT 
1B VLBSENDF — Special function flags 
| eee VLBCLR Clear required 
a ee VLBSDT Start data traffic (SDT) required 
edie. gen VLBCANC Cancel! required 
are are VLBSIGRQ Signal required 
- lili Zero 
1C X'FF' to indicate data trace entry 


1D-—1F Caller’s return address 
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DTIVSNDX 


00 


04 


08 


6c 


10 


14 


18 


1¢ 


Displacement: 


Ces 
[os [2 


00-03 Characters ‘VSND’ 
RPL request code 
Input RPL address 
Invalid TAB address 
VTAM Services local block (VLB) address 


04 
05 — 07 
08 — 0B 
0C — OF 
10-13 
14—1B 
1C 
1D 


1E 
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™~ 


Mod. flow 


Command check 

Data check 

Command reject 

Equipment check 

Data check and unit specify 
Equipment check and unit specify 
Reflect attention, CC1 on SIO 
SEND canceled - CANCEL key 
Presentation space integrity lost 
Unrecoverabie internal error 
Successful completion 

TWX read error sense X'0827' 
Printer not available 
Intervention required 

Printer busy 

Unrecoverable I/O error 
Unconditional logoff 

Operation check 


Input WEB address 

Zero 

X'FF' to indicate data trace entry 
WEBVSRPS 

X'15! WEBVSCC 
X'14! WEBVSDC 
X'13' WEBVSCRJ 
X'12! WEBVSEC 
X' 11! WEBVSDCU 
X'10' WEBVSECU 
X'OF' WEBVSCC1 
X'OE' WEBVSCNL 
X'OD' WEBVSPSL 
X'OC' WEBVSVER 
X'08' WEBVSAOK 
X'07' WEBTWXER 
X'06' WEBVSNAV 
X'05' WEBVSIRQ 
X'04' WEBVSBSY 
X'03' WEBVSERR 
X'02' WEBVSLFU 
X'01' WEBVSOPC 
Zero 
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1F Module flow indicator 
Ligale Arado DTIVPURG called 
delice fences DTIVLOFF called 
sty Leis siete Entry ignored — logical unit undergoing CLSDST 
eee Holes Entry invalid — TAB invalid or CID mismatch 


vu Cleanup Error Trace Record Format 
The vscs cleanup trace is activated automatically if any of the other vscs traces are 
active. The cleanup trace applies only to the set of logical units specified for the 
other vscs traces. Normal session terminations and error situations are traced. 
Two kinds of cleanup trace records are produced: 


e Logical unit-related 
e Data-related (associated with vscs global path). 


vM Format for a Cleanup Error Trace Entry 


04 WEBFUN DTITAB address 

OC PLBFLG1 PLBNOM 
14 VLBSWAP 

18 VLBCID 


Displacement: 


00-03 Four-character module ID (characters ‘PBRK’ or ‘VPUR’) 


04 WEBFUN code or zero (See “VM WEB Function Codes” on page 215.) 
05-07 TAB address for current request 
08 RPL request code 
09 LBCSTATE from PLB (See “VMLBCSTATE Values for PLBINxxx” on 
page 214.) 
Tacit ate LBCINT Internal mode if on (on=1). If LBCINT is 


on, see “VMLBCSTATE Values for 
PLBINxxx” on page 214. If LBCINT is off, 
the following values apply: 

eee LBCFSSMF _ Full-screen support mode flags 


5 ee ae LBCFSAV Screen available 
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0A PLBFSSMF 


0B PLBLFLG1 


0C PLBFLG1 
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= 


LBCFSII 


LBCCOPY 
LBCNAL 
LBCHOLD 
LBCM10 
LBCM50 
LBCCMSD 


Full-screen input inhibited: 


B‘'0O’ CP (Console) MODE 

B'01’ Virtual machine mode state 
between ATTN and READ, 
QUEUE CP messages 

B‘'10’ Virtual machine mode queue CP 
messages 

B'11’ Virtual machine mode available 
for switch. 


- Copy mode: on=1 


NAL flag: on=1 

Holding flag: on=B‘11' 

‘More’ 10 flag: on=1 

‘More’ 50 flag: on=1 

Screen written with a CMS DIAGNOSE: 
on=1 

No more holding state 


Full-screen support mode flags 


PLBFPA1 
PLBFSRFC 
PLBFSAFC 
PLBFCNMP 
PLBFVSIP 
PLBFCLGF 
PLBFCMRR 


PLBCMSEW 


PLBVS 


PLBLGFC 
PLBLGFU 


PLBLERR 
PLBLLERR 


PLBLVERR 


PLBLSEVR 


PLBNSTR 


PLBLGO 
PLBINAR 
PLBPASPA 


PLBLFLNP 
PLBCONCT 


PLBCNCTI 
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PA1 key received switch mode 

Mode switch required (FSSM to Console) 
Switch available (FSSM to Console) 
Console message pending 

VTAM Services SEND in progress 
Conditional logoff received 

CP message pending, response required 
Screen just cleared 


VTAM Services logoff received bypass 
logo 

WEBINLGF sent to CCS conditional logoff 
WEBINLGF sent to CCS unconditional 
logoff 

WEBINERR sent to CCS for hard error 
WEBINLER sent to CCS for interface 
error 

WEBINVER sent to CCS for internal logic 
error 

CP CCS SEVER received, VSCS must 
sever 

No storage indicator in logoff processing 


Logo or no logo bit (logo = 1) 

APL or TEXT starting in input area 
Pass PA1 as data (FSSM; VTAM V3R1 
only) 

Logon from logo not permitted 


Current connect count incremented for 
logical unit 
IUCV CONNECT has been issued 
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OD—-OE PLBNOM 


0D 


OE 


OF 


10 


11 


12-13 
14 
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PLBNFLG1 


PLBNFLG2 
2111 1111 
PLBOFLG1 


@#eo8 rarer | 


LBCSTATE 
e#ose @eee 1 


VLBLRCD 


ete are 
Zero 
VLBFLG 


PLBINREG 
PLBPRMPT 


PLBSDIAL 
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Input received during purge 


Usability prompt message flag. 


For display terminals: CP READ 
received but prompt not sent. 


For hardcopy terminals: VSCS sent 
prompt to logical unit. 

Zero (VTAM V3R1 only) 

SNA-dialed logical unit 


Notify output manager 


NOM flag 1 
PLBCEND 
PLBRDTX 
PLBSAC 
PLBCLROA 
PLBCLRIA 
PLBRING 


PLBUNLK 
NOM flag 2 
PLBRDPND 


Command end (read) 

The redisplay timer has expired 
Status area change required 
Clear output area 

Clear input area 

Ring the alarm 

Zero 

Unlock keyboard 


Redisplay pending 
Zero 


Output manager flags 


PLBSDIAG 
PLBPSMSG 
PLBOSRIP 
PLBOKLOK 
PLBOKPMI 
PLBOSWRT 
PLBOCRRQ 


PLBOEXRQ 


From VLB 
LBCVSST 


CMS DIAGNOSE on screen 

Priority message on screen 

SEND retry in progress 

Keyboard locked 

Hardcopy terminal mask input area sent 
CMS WRITE active (no input received) 
Carriage return required before SEND 
(on hardcopy terminal) 

‘l’ required before SEND (on hardcopy 
terminal) 


VTAM Services state: 0 = Normal, 
1 = Termination 


Logoff reason codes 


VLBVTLO 
VLBVRY! 
VLBHLTQ 
VLBHLTC 
VLBIOE 
VLBINERR 


VLB flags 
VLBBSPBB 


VTAM LOGOFF 

VARY INACTIVE 

HALT QUICK 

HALT CANCEL 
Unrecoverable I/O error 
Internal error 

Zero 


Bracket state - pending begin bracket 
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VLBBSPEB Bracket state - pending end bracket 

VLBBSINB Bracket state - in bracket 

VLBSR Application SEND or RECEIVE state: 
1 = SEND state,0 = RECEIVE state 
Zero 

VLB flag 1 

VLBIOTR Inbound data received since last SEND 
indicator 

VLBCLSD -.CLSDST: 0 = required, 1 = not 
required 

VLBPCS Purging chain state 

VLBSIGNL Signal sent 

VLBCHGD Change direction required 

VLBRETR Retry RECEIVE request 

VLBRETS Retry SEND request 
Zero 

VLB flag 2 

VLBRPLB RPL in use 

VLBCLPND VTAM CLSDST pending 
Zero 

VLBBUSY Printer busy 

VLBNAV Printer not available 

VLBOPCK Operation check occurred 

VLBWAIT Waiting for data or LUSTAT 


Special send indicator 


VLBCLR CLEAR required 
VLBSDT SDT required 
VLBCANC CANCEL required 
VLBSIGRQ ~~ SIGNAL required 


Zero 


. 1111 
15 VLBFLG1 
Less: sews 
os ee 
le 3 
pre ere 
a Meiers 
eS 
me Ue 
Silat. soit 1 
16 VLBFLG2 
i ee ree 
7 ae 
re) eee 
Paes rare 
Pe ar 
eels 
ee 1 
17 VLBSENDF 
Lies: “aes 
oe ee 
ory hae 
ae ere 
~ 1lll 
18-—1B VLBCID 
19 TRCFLOW 
1D—-1F Address 
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Network address pair (CID) 
Cleanup-module-dependent data 
DTIWEB if WEBFUN not zero, RPL if RPLREQ not zero 
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‘:i Cleanup-Module-Dependent Data 
DTIPRBRK (ID =‘PBRK’): Trace flow flags are set as follows: 


01 TRXPURG Logical unit in PLBINPRG (88) state 
02 TRXNWEB No input WEB 

03 TRXLOGO Logo error 

04 TRXCOND Conditional logoff 


DTIVPURG (ID =‘VPUR’): Trace flow flags are set as follows: 


Vets eat Schedule failed 

EMecgs duos Storage shortage 

» XX XXXX Space reserved for module flow indicator 

01 TRXNTERM NOTERM entered 

02 TRXLTERM ~ Logical unit in termination 

03 TRXWORK VSCS ignoring work to process request 

04 TRXNWORK _ No work to process DTIVLOFF called 

05 TRXCONN Logical unit in termination state with CCS con- 
nection 

06 TRXACTIV Logical unit state is not termination with no con- 
nection 

07 TRXIGNOR CCS has been notified or DTIPRBRK has set a 


timer to force purge. VSCS is waiting. 
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vm VSCS FORCE Trace Entry (V3R2) 


. 
08 LBCSTATE PLBNFLG1 | PLBOFLG] 
10 VLBSWAP 


Displacement: 


00 —03 
04-07 
08 
page 214.) 
Wee? Seiek.e 
tile oan 
lee 
gral 
Rade sages 
Pay ree 
Srierick ee DLS 
Po Oe 
ales 
Sitios vate l 
09 PLBLFLG1 
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Four-character module ID 
Tab address for current request 
LBCSTATE from PLB (See “VM LBCSTATE Values for PLBINxxx” on 


LBCINT 


LBCFSSMF 
LBCFSAV 
LBCFSII 


LBCCOPY 
LBCNAL 
LBCHOLD 
LBCM10 
LBCMS50 
LBCCMSD 


PLBVS 


PLBLGFC 
PLBLGFU 


PLBLERR 


Internal mode if on (on=1). If LBCINT is 
on, see “VM LBCSTATE Values for 
PLBINxxx” on page 214. If LBCINT is off, 
the following values apply: 

Full-screen support mode flags 

Screen available 

Full-screen input inhibited: 


B'00' CP (Console) mode 

B‘'O1' Virtual machine mode state 
between ATTN and READ, 
QUEUE CP messages. 

B‘10’ Virtual machine mode queue CP 
messages. 

B11’ Virtual machine mode available 
for switch. 


Copy mode: on=1 

NAL flag: on=1 

Holding flag: on=B'11' 

‘More’ 10 flag: on=1 

‘More’ 50 flag: on=1 

Screen written with a CMS DIAGNOSIS: 
on=1 

No more holding state 


VTAM Services logoff received bypass 
logo 

WEBINLGF sent to CCS conditional logoff 
WEBINLGF sent to CCS unconditional 
logoff 

WEBINERR sent to CCS for hard error 
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nae) ee PLBLLERR WEBINLER sent to CCS for interface 
error 
sss PLBLVERR  WEBINVER sent to CCS for internal logic 
error 
a PLBLSEVR CP CCS SEVER received, VSCS must 
sever 
Send tees 1 PLBNSTR No storage indicator in logoff processing 
OA-OB PLBNOM Notify output manager 
OA PLBNFLG1 NOM flag 1 
| Pore PLBCEND Command end (read) 
Pa pee PLBRDTX The redisplay timer has expired 
son Ties 2 PLBSAC Status area change required 
tall oatees PLBCLROA Clear output area 
Riot: Lene PLBCLRIA Clear input area 
mm ee PLBRING Ring the alarm 
cad Zero 
Saas eee 1 PLBUNLK Unlock keyboard 
0B PLBOFLG1 Output manager flags 
| ae eee PLBSDIAG CMS DIAGNOSE on screen 
ay ee PLBPSMSG ss Priority message on screen 
re eae PLBOSRIP SEND retry in progress 
eek aa PLBOKLOK Keyboard locked 
5 eee PLBOKPMI Hardcopy terminal mask input area sent 
cles PLBOSWRT CMS WRITE active (no input received) 
webs PLBOCRRQ Carriage return required before SEND 
(on hardcopy terminal) 
re | PLBOEXRQ _ '‘!' required before SEND (on hardcopy 
terminal) 
0c TABDTYPE 
01 DTYPEDSP for a display 
02 DTYPEKP for a keyboard/printer 
02 DTYPEPRT for a printer 
OC TABDSUB 
01 VDEV3767 for a 3767 
02 VDEV2741 for a 2741 
02 VDEVTWX for a TXW/TTY/3101 
OE LBCSTATE VLB 
Saciar tens 1 LBCVSST VTAM Services state: 0 = Normal, 
1 = Termination 
OF VLBLRCD Logoff reason codes 
Leia: ioaeds VLBVTLO VTAM LOGOFF 
sles VLBVRY! VARY INACTIVE 
ot oer VLBHLTQ HALT QUICK 
Seek Gaus VLBHLTC HALT CANCEL 
wecaet Lioacs VLBIOE Unrecoverable I/O error 
a ee ee VLBINERR Internal error 
cee. veld Zero 
10 VLBFLG VLB flags 
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VLBBSPBB 


VLBBSPEB 
VLBBSINB 
VLBSR 


VLB flag 1 
VLBIOTR 


VLBCLSD 


VLBPCS 
VLBSIGNL 
VLBCHGD 
VLBRETR 
VLBRETS 


VLB flag 2 
VLBRPLB 
VLBCLPND 


VLBBUSY 
VLBNAV 


~VLBOPCK 


VLBWAIT 


Bracket state-pending begin bracket 


Bracket state-pending end bracket 
Bracket state-in bracket 


Application SEND or RECEIVE state: 
1 = SEND state,O0 = RECEIVE state 


Zero 


Inbound data received since last SEND 
indicator 

CLSDST: 0 = required, 1 = not 
required 

Purging chain state 

Signal sent 

Change direction required 

Retry RECEIVE request 

Retry SEND request 

Zero 


RPL in use 

VTAM CLSDST pending 
Zero 

Printer busy 

Printer not available 
Operation check occurred 
Waiting for data or LUSTAT 


Special function flags 


VLBCLR 
VLBSDT 
VLBCANC 
VLBSIGRQ 


Clear required 
SDT required 
Cancel required 
Signal required 
Zero 


Logical unit name being forced 

X'FEF' to indicate data trace entry 

Module flow indicator 1 done by SPECIALX 
SPECIALX called 

CONECTYS called 

CONECTNO called 

COPYSIT called 

DTIPRCLP called 

DTIPRBRK called 

DTIPRSVR called 

DTIPRLGF called 

Module flow indicator 2 done by SPECIALX 
SPECIALX called 

CONECTYS called 

CONECTNO called 

COPYSIT called 
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vu MSCS Storage Trace Entries 


vm FREB Trace Entry (V3R2) 


00 


04 


08 


OC 


10 POOL 
14 
18 


1C 


Displacement: 


RETURN1 ADDRESS 
RETURN2 ADDRESS 
RESERVED 
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DTIPRCLP called 


DTIPRBRK called 
DTIPRSVR called 
DTIPRLGF called 
Queue Status indicators 


LUNORMAL Logical unit control blocks on norma! 
queue 

LUREC Logical unit control blocks on recovery 
queue 

LUPQUEUE PS PIB on PS dispatcher queue 

LUVQUEUE VS PIB on VS dispatcher queue 

LUBFKPIB WEBCPBRK on PS PIB work queue 

LUBRKLBC  WEBCPBRK on LBC pending queue 

LUVSBRK WEBVSBRK found on one of the work 
queues 

LUNTF60 WEBNTF60 found on PS PIB 


NUMBER 


00-03 Characters ‘FREB’ 


04-07 DTIPDB address 
08-—0OB Block being freed 


OC-OD SMP header 
OE—-OF Block 1D 


10 Storage poo! number 
1 Presentation Services 
2  VTAM Services 
3 VTAM Exit Services 


11-13 Zero 


14—17 Caller’s return address 
18—1B Caller’s caller’s return address 


1C—1F Zero 
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... GETB Trace Entry (V3R2) 


00 

04 DTIPDB ADDRESS 

08 BLOCK ADDRESS 

: 


Displacement: 


00-03 Characters ‘GETB’ 
04-07 DTIPDB address 
08—0OB Block being obtained 
OC -—OD Size requested 
OE—OF Size to be cleared 
10 Storage pool number 
1 Presentation Services 
2  VTAM Services 
3 VTAM Exit Services 
4 Special request 
11-13 Zero 
14-17 Caller’s return address 
18-—1B Caller’s caller’s return address 
1C—1F State 
ENAB Caller running enabled 
DISB Caller running disabled 


.. VSCS Data Trace Entries 


vi. Input Trace Entry (V3R2) 


DTITAB ADDRESS 


DTIWEB ADDRESS 


08 WEBFUN WEBMOD WEBCOUNT 
10 | WEBDATA | 


Displacement: 


00 


04 


00 Character ‘!’ for Input 
01—03 DTITAB address 
04-07 Work element address 
08 WEB function code 
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09 WEB mode 

00 Console 

01 CMS 

O02 Full-screen 

04 Internal 

Length of actual data in WEBDATA 


WEBDATA (20 bytes for internal, or 223 


OA—-0B 
10-xx 


vit Output Trace Entry (V3R2) 


cL am 


Displacement: 


00 Character ‘O' for Output 
01-03 DTITAB address 
04-07 Work element address 
08 WEB function code 
09 WEB mode 
00 Console 
01 CMS 
02 Full-screen 
04 Internal 
OA-—OB Length of actual data in WEBDATA 
10-xx WEBDATA (20 bytes for internal, or 223 


va LBCSTATE Values for PLBINxxx 


vii Console Mode 


vii CMS Edit Mode 
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bytes for external) 


bytes for external) 


50 second timer set 
10 second timer set 


50 second timer set 
10 second timer set 


Name Hex Value Description 

PLBINNMH ~ 00 No ‘More’ or ‘Holding’ condition 
PLBINM50 02-03 More condition, 

PLBINM10 04-05 More condition, 

PLBINHLD 06 — 07 Holding 

PLBINNAL 08 — OF Not Accepted logic applies 
PLBINCPY 10—1F PF key Copy in progress 

Name Hex Value Description 

PLBINCMS 01 No ‘More’ or ‘Holding’ condition 
PLBINM50 02-03 More condition, 

PLBINM10 04-05 More condition, 

PLBINHLD 06 — 07 Holding 

PLBINNAL 08 — OF Not Accepted logic applies 
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v.. Full-Screen Support Mode (FSSM) 


Name 
PLBINFSS 


«i Internal Modes 


Name 
PLBINLIP 
PLBINLUP 
PLBINCIP 
PLBINUP 
PLBINAWL 
PLBINLGF 
PLBINCLF 
PLBINSVR 
PLBINPRG 


.. WEB Function Codes 


Hex Value 
20, 40, 60 


Hex Value 
80 
81 
82 
83 
84 
85 
86 
87 
88 


Description 
Full-screen support mode 


Description 

Logon in progress 

Logo up 

Connect in progress 
Inlog in progress 
Attention wait before logo 
Logoff 

Conditional logoff 

Sever required 

Purge in progress 


The tables in this section show the bits defined in field WEBFUN, the function code 
for vscs. The function code depends on the value in WEBMODE: 


¢ |f WEBMODE is 04, use “vm Function Codes for Internal States” on page 216. 


Internal function codes represent work functions within vscs. These are not 
considered to be inbound or outbound. 


e For all other WEBMODEsS: 


— For inbound, use ‘vm Function Codes for Inbound Processing in All Modes” 
on page 216. 


Inbound function codes represent work elements that are received by Ccs. 


— For outbound, use the WEBMODE: 


— If the WEBMODE is 00, use “viw Function Codes for Outbound Processing 
in Console Mode” on page 217. 


— If the WEBMODE is 01, use “vi Function Codes for Outbound Processing 
in CMS Mode’ on page 217. 


— If the WEBMODE Is O02, use “vai Function Codes for Outbound Processing 
in Full-Screen Mode” on page 218. 


Outbound function codes represent work functions sent from CCS to VSCS, or 
generated internally invscs. The mode of the request (CMS, Console, or 
FSSM) determines which function is performed. 


Note: In this book, whenever a flow is referred to as inbound or outbound, you 
should take the Console Communications Services (CCS) as the reference point. 
That is, flows toward the CCS are inbound; flows away from the CCS are outbound. 
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va Function Codes for Internal States 


Name 
WEBNTM10 


WEBNVLFC 
WEBNVLFU 
WEBINERR 
WEBINPUT 
WEBNVFLW 
WEBNSRSP 


WEBNVLGO 
WEBNACON 
WEBNSEVR 
WEBNMSGC 
WEBNTMS50 


WEBNTNAL 
WEBNTF60 


WEBVSBRK 
WEBNVASY 
WEBPSSRU 
WEBNVCLU 


WEBNSIML 
WEBNTCPY 


WEBNTPRT 


WEBINOFC 


Hex Value 
00 


01 
02 
03 
04 
05 
06 


07 
08 
09 
OA 
OB 


OD 
OE 


OF 
10 
10 
11 


12 
13 


14 


14 
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Description 

Timer expired - ‘More’ 10 second, 

source = System Services 

Logoff conditional, source = VTAM Services 
Logoff unconditional, source = VTAM Services 
Unrecoverable I/O error, logoff condition 
Attention identifier and optional data input 
Logoff warning, source = VTAM Services 
Input/output response (could be either normal or 
error), source = VTAM Services 

Logon response, source = VTAM Services 
Accept connect, source = CCS 

Sever connection, source = CCS 

IUCV one-way message complete, source = CCS 
Timer expired - ‘More’ 50 second, 

source = System Services 

Timer expired - not accepted 3 second 

Timer expired = FSSM 60 second, 

source = System Services 

Logoff request, source = Presentation Services 
Asynchronous error - WEBVSRPS indicates type 
send request, source = Presentation Services 
Internal VTAM request cleanup, source = VTAM 
services 

Request to VTAM Services to issue SIMLOGON 
PF key Copy wait for printer SIMLOGON timer 
expired 

Timer expired for request to release printer after 
RELREQ exit driven 


Operator issued VSCS FORCE command — proc- 
essing continues in DTIPFORC 


vw Function Codes for Inbound Processing in All Modes 
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Name 
WEBINLOG 
WEBINATT 
WEBINCB1 
WEBINLGF 


WEBINFNU 
WEBINAOK 
WEBINACT 
WEBINOPC 
WEBINLER 
WEBINVER 
WEBRDERR 
WEBINVTM 


Hex Value 
01 
02 
05 
06 


07 
08 
09 
OA 
OB 
0C 
OD 
OE 


Description 

Logon request 

Attention interrupt without data 

Move cursor back one 

VTAM-generated logoff condition, CCS logs user 
off 

FSSM request rejected, screen not in user mode 
Normal response 

Accounting data for CCS 

Operation check for FSSM request 

Logical interface error (DTIWEB) 

VSCS internal processing error 

Error in input data found by the NCP 

Identify VTAM user ID to CCS 
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vm Function Codes for Outbound Processing in Console Mode 


Name Hex Value Description 

WEBCPWRT_ 00 Write to next available line in output area 

WEBCPRED 01 Read request 

WEBCPBRK 02 Break connection (CP logoff or disconnect) 

WEBCPWIC 03 Write to input area and then position cursor as 
indicated in WEBCURSR 

WEBCPCPY 04 Copy request 

WEBCPIED 05 Invalid environment definition 

WEBCPFKR- 06 PFK reply - treat as terminal input 

WEBCPIDA 07 Data accepted, proceed with input processing 

WEBCPINA 08 Input not accepted 

WEBCPREX 09 IREPLY expected by way of synchronous 

WEBCPTAB- OA PF key tab operation 

WEBCPLER OB Logical interface error (WEB) (ISEND or reply) 

WEBCPLOG OC Logo 

WEBCPTMR- OD Command end (no output for command enterea) 

WEBCPPTH OE IUCV path ID 

WEBCPCAH OF Color and highlight map for advantage II 

WEBCPLSA 10 Device information (terminal command) 


vm Function Codes for Outbound Processing in CMS Mode 


Name Hex Value Description 

WEBCMWRT 00 Write to line number specified in WEBLINE 

WEBCMEWT 01 Erase output area and write to line number speci- 
fied in WEBLINE 

WEBCMCLR_ 02 Erase entire screen and refresh the format of the 


output, input, and status areas 
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vm Function Codes for Outbound Processing in Full-Screen Mode 
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Name 
WEBFSWRT 
WEBFSEWT 
WEBFSEWA 
WEBFSRDM 
WEBFSRDB 
WEBFSWSF 
WEBFSEAU 
WEBFSRBP 
WEBFSRMP 
WEBINCC1 
WEBINECU 
WEBINDCU 
WEBINEC 
WEBINCRJ 
WEBINDC 
WEBINCC 


Hex Value 
00 
01 
02 
03 
04 
05 
06 
O07 
08 
OF 
10 
11 
12 
13 
14 
15 


Description 

FSSM write 

FSSM erase/write 

FSSM erase/write alternate 

FSSM read modified 

FSSM read buffer 

FSSM write structured field 

FSSM erase all unprotected 

FSSM read buffer by position 
FSSM read modified by position 
FSSM reflect attention, CC1 on SIO 
FSSM equipment check and unit specify 
FSSM data check and unit specify 
FSSM equipment check 

FSSM command reject 

FSSM data check 

FSSM control check 
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Chapter 7. Using VTAM Service Aids 
Many different service aids are available to help you collect information about SNA 


network problems. This chapter describes when to use some of these aids and 
provides examples to help you interpret their output. 


Note: In addition to the service aids discussed in this chapter, you can use: 
e Chapter 6, “vm Using VSCS Service Aids” 
¢ Chapter 8, “Using the VTAM Internal Trace.” 


This chapter discusses a number of service aids. Figure 35 on page 222 shows 
where in the network you can use these aids. 


Traces Provided by VTAM _ 


VTAM provides several kinds of traces to record the flow of network events. Each 
trace occurs at a different point in the network (see Figure 35 0n page 222). This 
difference allows you to narrow down the problem by following an RU through the 
network and determining where in the network the RU Is incorrect. (The RU could 
be out of sequence or lost, the data in the RU could have been changed, and so 
forth.) 


The vTAM traces and their results are: 


e The buffer contents trace shows the contents of inbound and outbound 
message buffers. 


e The i/o trace shows (in order) all /o sent between VTAM and a particular 
network node. 


e The sms (buffer use) trace shows information about the use of buffers, including 
how often a buffer pool has expanded, how many buffers are currently being 
used, and what was the maximum number of buffers used since the last trace 
record was written. 


e MVS The TGET/TPUT trace shows each message as it passes between a TSO 
command processor and TSO/VTAM. 
Notes: 


1. The VTAM interna! trace (vIT) is discussed in Chapter 8, “Using the VTAM 
Internal Trace.” 


2. The vSCs trace facility (vM only) is discussed in Chapter 6, “vM Using VSCS 
service Aids.” 
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Figure 35. VTAM Traces 
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LL2 


You can activate vTAM traces when VTAN is started, or you can activate them only 
when they are needed. Use the TRACE option on the START command to begin the 
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trace when VTAM is Started. Use the MODIFY TRACE command to begin the trace 
when VTAM is already running. The TRACE start option and the MODIFY TRACE 
command have additional operands that are unique to the type of trace being 


started. For more information about using the TRACE start option, see VTAM Instal- 
lation and Resource Definition. For more information about using the MODIFY TRACE 


command, see VIAM Operation. 


MVS VTAM passes all trace data to the Generalized Trace Facility (GTF), which 
records all system trace data. Because of this, GTF must be active to use VTAM 


traces. Specify TRACE=RNIO for the vTAM1/0 trace. Specify TRACE=USR for all other 


VTAM traces. 
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VM VTAM and VSCS pass all trace data to CPTRAP, using the GTRACE macroinstruction. 
CPTRAP must be active with format type 3D active. In addition, an ETRACE command 
(with the GTRACE and GROUP operands) must be entered for the vTAM and vscs 

virtual machine. For details, see “VM Using CPTRAP and TRAPRED” on page 225. 


VSE VTAM passes all trace data to the vTAM trace file. 


Printing Trace Records 
Once the trace data is recorded, you can use one of the following facilities to print 
the traces: 


e Trace analysis program (TAP) 
¢ MVS PROMP 

¢ VM TRAPRED 

@ VSE TPRINT. 


The following table indicates which traces can be formatted and printed by each of 

the formatting programs. In this table, ‘FP’ indicates that the trace is both formatted 
and printed; ‘up’ indicates that the trace is printed but not formatted. A blank entry 

indicates that the trace is neither formatted nor printed. 


[Buterconenivece =P =irP rR 
series rvvawe fe [| 
I/O trace Fp FP 

Line vas ere 
[Neworkeontalerinewace ie | | «dS 
[Scemnerinerace vace P| YS 
freevreutiece SYS Yd 
[vscsinernatvece «| SCC 
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Using TAP 


mvs Using PRDMP 
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You can format and print the following vTAM traces (and only these traces) with the 
trace analysis program (TAP) by setting the indicated option on the INPUT operand: 


Specify: To format and print: 


LINE Line trace 

LINE Scanner interface trace (3720, 3725, and 3745 only) 
LINE Transmission group trace 

GPT Generalized Plu trace 

RNIO /O trace 

BUFFER Buffer contents trace 


NETCTLR Network controller line trace 


TAP will print the SMS (buffer use) trace, but not format it. TAP also prints the VTAM 
and vscs internal traces, unformatted. TAP can print all internal trace entries, or 
you can select up to ten entry types. For more information on Tap, see the NCP, 
SSP, and EP Diagnosis Guide. 


For the VTAM I/O trace, set RNIO on the EDIT option. For all other vTAm traces, set 
USR = (symnum1[,symnume2]...[,symnum6] | ALL) on the EDIT option. 


symnum can be either a symbolic name or a number representing the trace that 
you want formatted and printed. If you specify USR=ALL, PRDMP formats and prints 
all user and subsystem traces recorded by GTF (except for TGET/TPUT trace, which is 
printed unformatted). Following are the valid symbols and numbers for the vTAM 
traces: 


Symbol Number Trace 


INT1 FE1 VTAM internal trace 

TPIO FEF VTAM buffer contents trace — VTAM (traced in TSC) 
CLO1 FFI VTAM buffer contents trace — user (traced in API) 
CL02 FFO Sms (buffer use) trace 

LINE FF2 NCP 3705 line or TG trace 

APTH FE2 TSO/VTAM TGET/TPUT trace 


Note: The symbol and the number can be used interchangeably; for example, 
USR =(LINE) and USR=(FF2) are the same. 


See the Service Aids manuals for your operating system for more information on 
PRDOMP and GTF. 
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mvs Fields in VTAM Trace Output 
In addition to the fields produced by vTAM, the following mvs-only trace fields 
appear in VTAM traces: 


Field Header Meaning 


ASCB nnnnnnnn — The address of the AscB for the address space that created the 
record. This field appears in a buffer contents trace, I/o trace, 
line trace, SMS trace, or transmission group trace. 


CPU nnnn The 10 of the host processor in which the trace was run (applies 
only in a multiprocessor configuration). This field appears in an 
/O trace. 


JOBN CCCCCCCC The name of the job associated with the 1/0 operation (for an I/O 
trace) or the address space (for a buffer contents, SMS, line, or 
transmission group trace). 


RNIO The trace record was created by GTF (with TRACE =RNIO). 


USRXX nnn The formatting routine (AMDUSRXx). VTAM’s trace formatter is 
AMDUSRFD. nnn is the event ID that represents this trace. This 
field appears in a buffer contents trace, line trace, SMS trace, or 
transmission group trace. 


vm Using CPTRAP and TRAPRED 
To collect VTAM trace output in vm, issue the following commands from the vTAM 
console. 


Note: To collect vscs trace output, see “VM How to Run External VSCS Traces” on 
page 161. 


in CP 

CPTRAP 3D 

CPTRAP GROUPID gcsgroup 

CPTRAP START TO userid userid is the receiver of the spool file 


In GCS 
ETRACE GTRACE GROUP 


In VTAM 
VTAM F TRACE, TYPE=type, I1D=term_name 
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VTAM will now Start tracing to a spool file. When you have collected enough data 
and you want to stop tracing. issue the following commands: 


In CP 
CPTRAP STOP 


In GCS 
ETRACE GTRACE OFF 


In VTAM 
VTAM F NOTRACE,TYPE=type, ID=term_name 


At this point you will get a CP spool file in the reader of the user ID specified in the 
CPTRAP START command. There are two ways to format the data, using TRAPRED and 
using TAP. TAP is available only if you have installed ssp. To uSe TRAPRED, issue the 
following commands: 


ACCESS 193 x The Gcs formatting routines are on this disk. “x” is a user- 
specified file mode. 


TRAPRED fileno fileno is the spool reader file number. (Make sure the reader 
file is not in hold status.) 


3D Read VTAM records only. 
FORMAT Format the records. 
PRINTER 999999 Print the records. (There are other commands that allow you 


to view the CPTRAP file online. See the VM/SP System Pro- 
grammer’s Guide for vm R4, or the VM/SP Facility for System 
Programming for VM R5.) 


QUIT 
For more information on CPTRAP, see the VM/SP Operator’s Guide. For more infor- 


mation On TRAPRED, see the VM/SP System Programmer's Guide. (for VM R4) or the 
VM/SP Facility for System Programming (for VM R35). 


vm VM-Only Fields in VTAM Trace Output 


In addition to the fields produced by vTaM, the following vM-only trace fields appear 
in VTAM traces: 


Field Header Meaning 


Time-of-day Time when trace record was created. 
clock 

Length of GTF Indicates the length of this trace record. 
header and 

trace data 


Format routine Identifies formatting module used for this record. 
ID 
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vse Using TPRINT 


Field Header Meaning 


Event Information from GTRACE macroinstruction’s event ID parameter. 
identification 


The trace records generated by vTAM traces are directed to a vTAM trace file. Trace 
records in the trace file can then be printed by using the TPRINT utility program. 


The trace print utility runs as a subtask under VTAM or as a job step under vSE. To 
run the trace print utility as a subtask, the operator initiates printing with the MODIFY 
SUBTASK Command while VTAM is active. When the utility is run as a separate job 
step, printing can be done whether VTAM Is active or inactive. 


Job Step Procedure: The trace print utility can be executed through a job step pro- 
cedure that is defined when vTAM is installed. SYSLST is assigned to a tape, printer, 
or disk, and the trace file is defined in DLBL and EXTENT statements, for example: 


// — DLBL TRFILE, ‘VTRACE',1,SD 
// EXTENT — SYS004 

// ASSGN —- SYSQ04, 132 

// — ASSGN SYSLST,O2E 


// EXEC TPRINT 


SYSLST must be assigned to a printer, tape, or disk with the name lSyYSsLs. If it is not 
assigned, TPRINT is canceled. 


MODIFY SUBTASK Command: To start the trace print facility with the MODIFY 
SUBTASK Command, use the ID=TPRINT option. The operator is prompted to request 
a print of the TRFILE, using any of the print options available or a snapshot print. A 
Snapshot prints all the 1/O, BUF, LINE, and TNSTAT records in VTAM’s main storage I/O 
buffers, without accessing records previously written to TRFILE. (A snapshot print 
option is not available for the vTAm internal trace.) When the contents of TRFILE are 
being printed, all tracing is suspended until the printout is completed. 


Note: When the trace print facility is run as a subtask, the trace output is not 
printed by vSE until VTAM is halted. 


For more detailed information about initiating the trace print facility and the options 
available, see VTAM Operation. 


All trace records contain either a time-stamp or a formatted time and date field 
from which the order of recording can be determined. This information can be 
helpful in synchronizing buffer contents and 1/O traces and, to a lesser extent, VTAM 
and non-VTAM traces. 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 Chapter 7. Using VTAM Service Aids 227 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


The TPRINT User Exit Facility: An interface is provided in the trace print facility to 
allow the user to write an exit routine for the editing of VTAM trace records. The 
dummy user exit module, ISTRAEUE, can be replaced by an installation-supplied 
module. The dummy module is called by the trace writing module, iSTRACTO, with 
the following register contents: 


Register Contents 


0 0 = first entry to module 

1 = return for more output 
1 Address of parameter list 
13 Save area address 
14 Caller’s return address 
15 ISTRAEUE entry point address 


The parameter list pointed to by register 1 contains the following information: 


¢ Word1 address of trace record (iSTTRAB) 
e Word2 address of output buffer 
e Word3 address of date and time stamp for this record 


Consider the following points when programming a user exit routine for the TPRINT 
facility: 


¢ TPRINT provides support for reading TRFILE with VSE access methods DTFSD or 
DTFMT. The file format is standard variable blocked records with BLKSIZE = 2048. 
Each physical record contains a dummy 16-byte logical record that provides 
control information for TPRINT and is not passed to the user exit routine. The 
block header and the dummy record are mapped by the TRB. 


¢ The remaining logical records contain trace data. Each has a 32-byte header 
mapped by the TRAB. Each is passed to the user exit routine for processing. 
Contents of the TRAB header and data format and length vary according to the 
trace record type. 


¢ TPRINT provides access method support for all SYSLST output. Line counting and 
page headers are provided automatically. DTFDI is used with ASA control char- 
acters. The output buffer is cleared to blanks before the user exit routine is 
called. Use of control characters is limited to single space ( ), double space 
(0), triple space (-), and skip to channel 1 (1). When a skip is specified, TPRINT 
inserts its own page header and double space before printing the specified 
line. 


¢ The TPRINT user exit routine may provide its own access method interface to 
SYSLOG (console) or any other device. For example: A trace record showing 
only errors is desired; or data reduction processing of trace records, such as 
line or internal trace, may require operator specification of additional record 
selection options. 


e¢ Buffer, oOo, and TNSTAT records are single entry data records. Line and internal 
trace records contain one or more entries following the TRAB header. The user 
exit routine must perform all de-blocking logic for multiple-entry records, using 
return code 8 to request re-entry from TPRINT for additional processing of the 
___--same trace record. See Figure 36 on page 229 for an example of user exit 
routine logic. 
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Figure 37 on page 230 shows the format of trace records as recorded on the 
VTAM trace file (TRFILE). 


C=) 


Save registers 
and porameters 


First time 
for record? 


De-block next 
part of data 


Format header 
line 


End of data? 


Initialize dota 
de-blocking fields 


VIT entry to 


Obicin options be skipped? 


Initialize own 
processing 
options 


iy 
Is record VIT? = Set code 0 Set code 8 
or 4 in R15 InN R15 
No 


Set code 255 
in R15 


Set code Bin R15 Format data 


(partial) 


Restore 
registers 


Cm) 


Figure 36. vse TPRINT User Exit Routine Logic 
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Figure 37 (Part 1 of 2). vSE Trace Records on TRFILE 
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of REN [G00 
4 


Line (CS 3) 


OS O0000C0 


Time and date 
stamo 


Legend 
Flag bit O (direction): 1 = Inbound 
Flag bit 1: 1 = Confidential text 
ILRC = Inbound !ost record count 
O_RC = Outbound lost record count 


RLEN 


= Total record length 


Tuning statistics 
(TNSTAT) 


4 | 06 000000 


Time and date 
stemep 


Node ncme 


Hex O 


20 
9-byte 


RU header 24 4-byte 


data fields 


entries: first byte of 
0 = text data 
X = status informction 


; One or more datc 


Figure 37 (Part 2 of 2). vSeE Trace Records on TRFILE 
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Buffer Contents Trace 


The buffer contents trace shows the contents of message buffers in two places: the 
application program interface (API) and the transmission subsystem component 
(Tsc). When data is sent by an application program (outbound), Api is the first com- 
ponent of VTAM to process it, and TSC is the last component of vTam to process it. 
When data is received from the network (inbound), TSC is the first component of 
VTAM to process it, and APi is the last. To enable you to distinguish where in VTAM 
the trace data was recorded, the output specifies either USER (for data recorded in 
API) or VTAM (for data recorded in TSC). 


The AP! writes user buffer contents trace records while user data is still in the 
application program’s buffers, before it is copied into VTAM buffers. Only user data 
is recorded. 


TSC writes VTAM buffer contents trace records while the data is in VTAM fixed i/o 
buffers. The entire piu — that is, the transmission header (TH), request/response 
header (RH), and user data — is recorded. 


You can trace buffer contents data for messages to and from any of the following 
nodes: 


-¢@ Application program 

¢ Logical unit 

e Channel-attached 3270 

¢ SNA cluster controller 

¢ NCP 

e sscP 

¢ Host physical unit 

¢ Cross-domain resource 

e Cross-domain resource manager. 


The trace record has a maximum length of 256 bytes, including trace field headers, 
transmission headers, request/response headers, and data. 


Note: vTAm can start a buffer contents trace only for the resources that itowns. A 
data host, which does not own any NCPs, cannot start a buffer contents trace for an 
NCP or any of the NcP’s subordinate resources. 


When to Use the Buffer Contents Trace 


232 VTAM Diagnosis 


The buffer contents trace can help you determine whether a problem is in the host 
(VTAM or an application program) or in the network. For example, if an application 
program sends a message to a terminal, and the message is correct in vTAM buffer 
contents trace output, but the message does not appear correctly at the terminal, 
then the problem is probably in a system resource other than VTAM or the applica- 
tion program. 


The buffer contents trace cannot always be used to distinguish an application 
program problem from a VTAm problem. However, it can confirm the order in which 
data is passed between an application program and a logical unit. It can also 
record all the data passing to and from an application program. 


If you do not need to trace user data, use the I/O trace. 
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Buffer Contents Trace Operation 
Start the buffer contents trace with the MODIFY TRACE command or the TRACE start 
option. 


Specify: To Trace: 
ID = nodename Requests and responses flowing between VTAM and nodename. 
ID=VTAM Request and response units (RUS) for SSCP sessions. 


ID =ISTPUS Request and response units (Rus) for sessions between the host 
physical unit and another physical unit type 5 or a physical unit 
type 4 (these RUs include ER-ACT, ER-OP, and ER-TEST RUS). 


If you use the SCOPE=ALL or EVERY operand when you Start the trace, VTAM records 
messages to and from the specified node and all its valid subnodes. 


Note: You cannot use the SCOPE=ALL or EVERY operands with ID=ISTPUS. 


For more information on the MODIFY TRACE command, see VTAM Operation. For 
more information on the TRACE start option, see VTAM Installation and Resource 
Definition. 


mvs Make sure that GTF (with TRACE =USR) is active before starting this trace. To 
format and print the data recorded by GTF, use PRDMP and Set USR =(TPIO,CLO1) or 
USR = (FEF,FF1) on the EDIT option. 


Specify: To Cause PRDMP to: 
FF Format and print the buffer data recorded in the AP! component 


of VTAM. The trace output says “USER”. 


FEF Format and print the buffer data recorded in the TSc component 
of vTAM. The trace output says “VTAM”. 


vm Use cCPTRAP (with a format 1D of 3D) to collect buffer contents trace data. Enter 
the ETRACE command, using the GTRACE and GROUP operands. Use TRAPRED or TAP to 
format and print the output. 


vse Use TPRINT to print the buffer contents trace records. 


For more information on printing trace output, see “Printing Trace Records” on 
page 223. 


Buffer Contents Trace Output 
Figure 38 on page 234 shows an example of buffer contents trace output in mvs. 
(The output for vM and VSE are similar.) 


The trace fields are explained after the figure. In addition to the fields described 
here, additional operating-system — dependent fields may appear (in mvs and vM). 
For a description of these fields, see “mvs Fields in VTAM Trace Output” on 

page 225 and “vm VM-Only Fields in VTAM Trace Output” on page 226. 
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BUFF APPL12 /TERM200 LRC(000,000) INBOUND 

VTAM TH=40000000 200000C2 Q000 O00C 00000004 IC000005 0028004 0040 RH=030080 
7DD8E811 D7FIF3C8 C1E3C140 C9E240C3 *'QY.PITHIS DATA IS C* 
D6OD4D4C9 D5C740C9 D540D6D5 40E4E2C5 *OMMING IN ON THE USE* 


BUFF APPL12 /TERM200 LRC(000,000) OUTBOUND 
USER C5D5E3D09 40C4C1E3 C140E3D6 40C5C8D6 *ENTER DATA TO ECHO B* 
C5D3D6E6 4B5CFO4B D7D9C5E2 E240C5D5 *ELOW.*O.PRESS ENTER * 


Figure 38. Example of Buffer Contents Trace Output 


The following fields appear in the buffer contents trace: 


Field Header Meaning 


BUF destname/origname Is the destination (destname) and origin (origname) 
node name. In Figure 38 the destination is APPL12 and 
the origin is TERM200. 


LRO(xxx, yyy) The number of records lost since the last trace record 
was written because the trace facility could not get a 
VTAM buffer. xxx is the destination’s lost record count, 
and yyy is the source’s lost record count. 


INBOUND Or OUTBOUND The direction of the traced data (inbound or outbound) 
with respect to this host subarea. By use of this field 
and the PiU sequence number in the TH, requests and 
corresponding responses can be matched. 


VTAM Or USER Indicates where the message buffers were traced. 
VTAM means the buffers were traced in TSC (in which 
case the TH and the AH are included in the trace 
record). USER means the buffers were traced in API (in 
which case the TH and the RH are not included). 


TH The 26-byte transmission header portion of the path 
information unit (PiU). 


RH The 3-byte request/response header portion of the Plu. 


The rest of the trace record shows the contents of the buffer. Each line contains 20 
bytes of user data in five groups of eight hexadecimal digits followed by the equiv- 
alent 20 EBCDIC characters. 


Confidential data will not be recorded in trace records. When the trace facility 
detects confidential data (CONFTXT= YES is specified on the applications program’s 
NIB macroinstruction), the user data is replaced with the marker in the trace output. 


MVS vm The marker iS ‘CONFIDENTIAL AND SUPPRESSED . 
VSE The marker iS ‘CONFIDENTIAL DATA’. 


mvs If you are using the VTAM encryption facility, data on a cryptographic session is 
handled in the same way as confidential data. 
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1/O Trace 


The 1/0 trace shows requests and responses that flow between vTAM and network 
nodes. You can trace i/o activity for any of the following types of nodes: 


¢ Application program 

e Physical unit 

¢ Logical unit 

e SNA cluster controller 

° NCP 

* SSCP 

¢ Host physical unit 

¢ Host as an intermediate routing node 
¢ Channel attachment major node 
¢ Cross-domain resource 

¢ Cross-domain resource manager. 


The maximum 1/0 trace record length is 36 bytes. 


When to Use the I/O Trace 


1/O Trace Operation 


Use the i/o trace to record the order that Pius flow between network nodes and 
VTAM. For example, you might use this trace to determine whether an application 
program receives all the responses that it should and whether vtam forwards all 
the requests issued by the application program. 


The content of the 1/o trace is similar to that of the buffer trace, except that the 1/o 


trace records less user data. If you do not need this user data, you can save trace 
file space by using the /o trace. 


Start the 1/0 trace with the MODIFY TRACE command or the TRACE start option. 


Specify: To Trace: 

ID=nodename Requests and responses flowing between vTAM and nodename. 
ID=VTAM Request and response units (RUS) for sscP sessions. 

ID=ISTPUS Request and response units (RUs) for sessions between the host 


physical unit and another physical unit type 5 or a physical unit 
type 4 (these RUs include ER-ACT, ER-OP, and ER-TEST RUS). 


ID=ISTIRN Request and response units (RUS) that flow through this host 
while this host is acting as an intermediate routing node. 


If you use the SCOPE=ALL or EVERY operand when you start the trace, the trace 
records I/O activity for the specified node and ail its valid subnodes. 
Notes: 

1. You cannot use the SCOPE=ALL or EVERY Operands with ID=ISTPUS Or ID=ISTIRN. 

2. You must specify SCOPE=ALL when tracing a channel-attachment major node. 

3. You may trace a link in a channel-attachment major node, but not a link station. 


See VTAM Operation for information on the mopiFy command. See VTAM Installa- 
tion and Resource Definition tor more information on the TRACE start option. 
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MVS Make sure that GTF (with TRACE =RNIO) is active before starting this trace. To 
format and print the data recorded by GTF, use either PRDMP or TAP. For PRDMP, set 
RNIO On the EDIT option. 


VM Use cpTRAP (with a format ID of 3D) to collect 0 trace data. Enter the ETRACE 
command, using the GTRACE and GROUP operands. Use TRAPRED or TAP to format and 
print the output. 


VSE Use TPRINT Or TAP to print the trace records collected by the 1/o trace. 


For more information on printing trace output, see “Printing Trace Records” on 
page 223. 


MVS VM Figure 39 shows an example of 1/0 trace output. 
VSE Figure 40 shows an example of I/o trace output. 


The trace fields are explained after each figure. In addition to the fields described 
here, additional operating system dependent fields may appear (in MVS and VM). 
For a description of these fields, see ‘MVS Fields in VTAM Trace Output” on 

page 225 and “VM VM-Only Fields in VTAM Trace Output” on page 226. 


IN 40000000 200080B1 O000000C 00000004 OED00005 DOOB808D DOOA9B8D 00000841 00006000 


OUT 42000000 2000009A 00000004 O0D0000C OEDDODNB 0005808D OOOACB8O 00000823 00000000 


Figure 39. MYS VM Example of I/O Trace Output 


MVS VM _ The following fields appear in the 1/0 trace: 


Field Header Meaning 


IN Or OUT The direction of the trace record: IN for inbound to VTAM, and OUT 
for outbound to the specified node. When ISTIRN is specified, 
each RU Is traced twice — once when it enters VTAM (IN) and once 
when it leaves (OUT). 


The rest of the trace record is some or all the path information unit (Piu). It consists 
of a 26-byte transmission header (TH), a request/response header (RH), and as 
much of the request/response unit (RU) as will fit. The data length field in the TH 
indicates the length of the RH and RU in bytes. The RU may contain sense data. 


IQ TERMI2 / 671337102 31202.13 OUTBOUND 
TH=40000000000000000000000C00C0000C1D0000390005000D0028 RH=6B88000 RU=31010202714020 


10 PVERMT2 87. 153/102 31202015 INBOUND 
TH=40000000000000000000000CO000000C 1D0000050039000D6004 RH=EBB8000 RU=31 


Figure 40. VSE Example of 1/O Trace Output 
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vSE The following fields appear in the 1/o trace: 


Field Header Meaning 


lO destname/origname Is the destination (destname) or origin (origname) 
node name. Usually, only one node name will be 
resolved by the i/o trace. In Figure 40 on page 236 
the node name is TERM12 in both records. 


yy.jjj/hh:mm:ss.hh Is the year (yy), the Julian date (jjj), and the time to 
hundredths of a second (hh:mm:ss.hh) that trace 
record was written. 


To find this field in Figure 40 on page 236, look for 
“87.153/10:31:02.13" in the first trace record. 


LRC(XXx, yyy) Is the number of records lost since the last trace 
record was written because of the inability of the 
trace facility to get VTAM buffers. xxx is the destina- 
tion’s lost record count, and yyy is the source’s lost 
record count. This field is not present in the trace 
record unless records are lost. 


INBOUND Or OUTBOUND The direction of the traced data (inbound or outbound) 
with respect to this host subarea. With this field and 
the PiU Sequence number in the TH, requests and cor- 
responding responses can be matched. 


TH Is the 26-byte transmission header portion of the path 
information unit (PIU). The data length field in the TH 
indicates the length of the RH and Au in bytes. 


RH Is the 3-byte request/response header portion of the 
PIU. 
RU Ten bytes of the request/response unit, which may 


contain sense data. 


SMS (Buffer Use) Trace 
The storage management services (SMS) trace records contain information on the 
use and availability of VTAM buffer pools. Sms trace records are written after a pre- 
determined number of requests occur for VTAM buffers. An IBM-Supplied threshold 
Causes a trace record to be written after every 1000 (hex 3E8) requests. 


To change the IBM-supplied number (the halfword at label RACBSNAP in VTAM module 
ISTRACON), use the service aid SPZAP (in MVS and vM) or the utility aid MSHP (in VSE). 


Mvs See MVS Service Aids for a complete description of SPZAP. 


vM See the VM/SP Group Control System Guide for a complete description of 
SPZAP. 


VSE See the VSE/AF MSHP Reference for a complete description of MSHP. 
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Notes: 


1. If the DISPLAY BFRUSE command is issued while this trace is running, the fields 
MAX TOTAL, MAX USED. and TIMES ExP reflects buffer usage only since the last 
trace record was written, because the SMS trace resets these fields. 


2. The SMS trace is not the same thing as the vTAM internal trace with the sms 
option specified. The sms trace is similar to the DISPLAY BFRUSE Command. The 
SMS trace displays in trace output the same information that the DISPLAY BFRUSE 
command displays on the screen. 


When to Use the SMS Trace 
Use the SMS trace during VTAM installation to evaluate VTAM use of buffer pools, to 
help estimate how many buffers vTAM needs for normal operation, and, with 
dynamic buffering, to limit buffer pool expansions to peak use periods. You can 
use the SMS trace in conjunction with tuning statistics. 


SMS Trace Operation 
Start the sms trace with the MODIFY TRACE command, or use the TRACE start option 
with TYPE=SMS and ID=VTAMBUF specified. For more information about the MODIFY 
TRACE Command, see VIAM Operation. For more information about the TRACE start 
option, see VTAM Installation and Resource Definition. 


MVS Make sure that GTF (with TRACE =USR) is active before starting this trace. To 
format and print the data recorded by GTF, use PRDMP and Set USR=(FFO) or 
USR=(CL02) on the EDIT option. 


VM Use CPTRAP (with a format ID of 3D) to collect Sms (buffer use) trace data. Enter 
the ETRACE command, using the GTRACE and GROUP operands. Use TRAPRED or TAP to 
format and print the output. 


VSE Make sure that SDAID is active, and TRACE VTAMBU is Specified. The trace output 
can be printed with the DOSVSDMP utility program. For more information on SDAID 
and DOSvVSDMmP, see VSE Service Aids. 


For more information on printing trace output, see “Printing Trace Records” on 
page 223. 


vivs VM SMS Trace Record Output 
The SMS trace record format is the same for mMvS and vm. Figure 41 and Figure 42 
on page 239 show examples of SMS trace output. 


The trace fields are explained after the figures. In addition to the fields described 
here, other operating-system-dependent fields may appear. These fields are 
described in “Mvs Fields in VTAM Trace Output” on page 225 and “VM VM-Only 
Fields in VTAM Trace Output” on page 226. 


VTAM BUFFERS MAXU MAXQ AVNO TEXP MBUF TOTL MAXU MAXQ AVNO TEXP MBUF TOTL 
I0 0021 0000 0044 0000 0064 0064 PP 0000 0000 0000 0000 0000 0000 
LP 0004 0000 003E 0000 0040 0040 WP 0001 0000 001B 0000 0010 0010 
CR Q0O01 0000 0000 0000 0021 0021 UE 0000 0000 0022 0000 0022 0022 
SF 0002 0000 0021 0000 0033 0033 SP 0000 0000 9000 0000 9000 0000 


Figure 41. MVS VM Example of SMS Trace Output for VTAM Pre-V3R2 
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VTAM BUFFERS 


VTAM BUFFERS 


MAXU 
90000021 
080000000 
00000004 
00000001 
00000000 
00000000 


MAXU 
00000001 
00000000 
00000002 
00000000 
00000000 


MAXQ 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 


MAXQ 
00000000 
00000000 
00000000 
00000000 
00000000 


AVNO 
090000044 
00000000 
QOQ0003E 
00000018 
00000000 
00000000 


AVNO 
00000000 
00000022 
00000021 
00000000 
00000000 


TEXP 
00000000 
00000000 
00000000 
80000000 
00000000 
00000000 


TEXP 
00000000 
00000000 
00000000 
00000000 
00000000 


MBUF 
00000064 
00000000 
00000040 
00000010 
00000000 
00000000 


MBUF 
00000021 
00000022 
00000033 
00000000 
00000000 


TOTL 
00000064 
00000000 
00000040 
00000010 
00000000 
00000000 


TOTL 
00000021 
00000022 
00000033 
00000000 
00000000 
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Figure 42. MVS VM Example of SMS Trace Output for VTAM V3R2. Two separate records 
will be printed, and they may be separated by another trace entry. 


The following fields appear in the SMS trace for MVS and vM: 


Field Header Meaning 

Pool ID Is the first field in each record and identifies the buffer pool. 
Pool !Os and their corresponding buffer pool names are: 

AP Application program pageable pool (APBUF) 

CR Copied RPL pool (CRPLBUF) 

fe) Fixed 1/0 pool (lOBUF) 

LF Large fixed pool (LFBUF) 

LP Large pageable pool (LPBUF) 

SF Small fixed pool (SFBUF) 

SP Small pageable pool (SPBUF) 

WP Working set pageable pool (wPBUF). 

Note: NPBUF, PPBUF, and UPBUF are no longer used by VTAM. 

MAXU The maximum number of buffers in the pool that were in use at 
any time since the last trace record was written. 

MAXQ The maximum number of requests for buffers that were queued 
waiting for storage at any time since the last trace record was 
written. 

AVNO The number of available buffers (those not in use at the time the 
trace record was written). 

TEXP The number of times the buffer pool was expanded since the last 
trace record was written. 

MBUF The maximum number of buffers that were in the pool at any 
time since the last trace record was written. This includes both 
used and unused buffers. 

TOTL The total number of buffers that were in the pool at the time this 


record was written. This includes both used and unused buffers. 
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vsE SMS Trace Record Output 
Figure 43 shows an example of SMS trace output for vSE. The trace fields are 
explained after the figure. 


VTAM BUFFER POOL USE SEQ. NO = 00000001 DAY 223 TIME 08:21:43 

VF IN USE=O00011 MAX ALLOC=00011 MAX WAIT=00000 EXPAND=00000 MAX AVAIL=00000 CUR AVAIL=00000 
VP IN USE=00397 MAX ALLOC=00424 MAX WAIT=00000 EXPAND=Q0000 MAX AVAIL=00000 CUR AVAIL=00000 
SF IN USE=Q0009 MAX ALLOC=00011 MAX WATT=00000 EXPAND=00000 MAX AVAIL=00022 CUR AVAIL=00002 
LF IN USE=00045 MAX ALLOC=00109 MAX WAIT=00C00 EXPAND=00027 MAX AVAIL=00116 CUR AVAIL=00063 
SP IN USE=00000 MAX ALLOC=00001 MAX WAIT=00000 EXPAND=00000 MAX AVAIL=00022 CUR AVAIL=00003 
LP IN USE=Q0005 MAX ALLOC=00011 MAX WAIT=00000 EXPAND=00003 MAX AVAIL=00015 CUR AVAIL=00009 
WP IN USE=00079 MAX ALLOC=00087 MAX WAIT=00000 EXPAND=00003 MAX AVAIL=00099 CUR AVAIL=00027 


= 


Figure 43. VSE Example of SMS Trace Output 
The following fields appear in the SMS trace for VSE: 


Field Header Meaning 


Pool ID Is the first field in each record. It identifies the buffer pool. Pool 
IDs and their corresponding buffer pool names are: 


LF Large fixed pool (LFBUF) 

LP Large pageable pool (LPBUF) 

SF Small fixed pool (SFBUF) 

SP Small pageable pool (SPBUF) 

VF Variable fixed pool (vFBUF) 

VP Variable pageable pool (VPBUF) 

WP Working set pageable pool (WPBUF). 
Notes: 


1. Sometimes pool names are not listed. The pool names are 
not available when vTam is running disabled. 


2. APBUF, NPBUF, PPBUF, and UPBUF are no longer used by VTAM. 


IN USE Indicates the number of buffers in the pool that were in use at 
any time during the time covered by the snapshot dump. For the 
VP and VF pools it indicates the number of pages that were in use 
at the time the snapshot dump was taken. 


MAX ALLOC Indicates the maximum number of buffers in the pool that were 
in use at any time during the time covered by the snapshot 
dump. For the vp and vF pools it indicates the maximum number 
of pages in use. 


MAX WAIT Indicates the maximum number of requests for buffers that were 
queued waiting for storage at any time during the time covered 
by the snapshot dump. For vF and vP pools this field has no 
meaning. 


EXPAND Indicates the number of times the buffer pool was expanded 
during the time covered by the snapshot dump. For vF and vp 
pools this field has no meaning. 
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Field Header Meaning 


MAX AVAIL Indicates the maximum number of buffers that were in the pool 
at any time during the time covered by the snapshot dump. For 
VF and vP pools this field has no meaning. 


CUR AVAIL Indicates the number of buffers that were in the pool at the time 
the snapshot dump was taken. For vr and vp pools this field has 
no meaning. 


mvs TGET/TPUT Trace for TSO/VTAM 
The TGET/TPUT trace for TSO/VTAM writes a GTF trace record for each inbound and out- 
bound message that uses the TGET/TPUT/TPG interface (Svc 93) between a TSO 
command processor and the vTioc component of TSO/VTAM. Outbound messages 
are traced before being placed in the vTioc queue manager output buffer. Inbound 
messages are traced before the data is sent to the TSO command processor. 


Note: The TGET/TPUT trace does not trace address space ID TPUTS. 


MvS When to Use the TGET/TPUT Trace 
Use this trace if the failure is restricted to Tso sessions. This trace can help you 
determine whether TSO/VTAM or your TSO Command processor is causing the 
problem. For example, if outbound data is correct in the TGET/TPUT trace output, but 
incorrect in the buffer trace output, the problem is probably in TSO/VTAM or VTAM. 
Use the following tables as a guideline to determine where the error is occurring: 


Direction if TPUT And Buffer or I/O Then Possible 
of Data Trace Data Is: Trace Data Is: Error Is In: 
e VTAM 


Outbound Correct Incorrect 
e TSO/VTAM 
command 


e TPUT option 
Outbound Incorrect Trace not 
processor 


e User edit 
required 


exits 
Figure 44. MVS Location of TPUT (Outbound) Error 


TSO or the 
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Direction If TGET And Buffer or I/O Then Possible 
of Data Trace Data Is: Trace Data ls: Error Is In: 
e 


Inbound Incorrect Correct VTAM 

¢ TSO/VTAM 
¢ TGET option 
e User edit 
exits 


TSO or the 
command 
processor 


Inbound Incorrect Incorrect Network 


Figure 45. MVS Location of TGET (Inbound) Error 


Trace not 
required 


Inbound Correct 


MVS TGET/TPUT Trace Operation 


Start the TGET/TPUT trace with the MODIFY TRACE command and specify TYPE=TSO. 


The trace output is a record of inbound and outbound messages for the specified 
TSO uSer ID. 


Make sure that GTF (with TRACE=USR) is active before starting this trace. To print 
these trace records, use PRDMP with USER = (FE2) specified. 


For more information on printing trace output, see “Printing Trace Records” on 
page 223. 


MVS TGET/TPUT Trace Output 
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The trace records created by the TGET/TPUT trace have a 12-byte GTF header and a 
32-byte trace header followed by the data portion of the RU in unformatted 
hexadecimal. The entire Ru is traced, but will span several trace entries if it is 
longer than 228 bytes. 


Figure 46 on page 243 shows an example of TGET/TPUT trace output. The trace 
fields are explained after the figure. 
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TIME 26261 .617577 
HEXFORMAT AID FF FID OO EID EFE2 Q000 OOFED640 C50905C9 C5404040 ESE2ZD6D6 FE4E50300 DSCIE2ZES *..0 ERNIE TSOOQUT. . LAST + 


TIME 26261 .618125 0018 CS5D9D0SC9 C5404040 O3F3CSF1 40404040 QO0000000 C9D5SC1D3 *ERNIE L3E1 ....ENAL* 
0030 40E6C9E3 C81D60F2 F411C7D6 40404040 11C76010 603C4B60 * WITH. .24.G0 SO 2 horexS * 
0048 403C4F5F 403CD35E 403CD75D 403C5B5C 40304040 4011C1iE4 »« ... .L. .P. ww, .AUs 
0060 13 *. * 


TIME 26261 .618125 
HEXFORMAT AID FF FID 00 EID EFE2 
TIME 26265.370315 


C5D9D5C3 £5404040 D3F3C5F1 40404040 000 00 70C1E511 *ERNIE ESE ‘ahead AV. = 
sAUS 


0000 | OOFED640|CSD9DSC9 C5404040 E3SEZD6C9 05408100 DSCIEZE3 *..0 ERNIE TSOIN ..LAST# 
0 
TIME 26265.370315 


eee DATE DAY 094 YEAR 1985 TiME 12.17.45.$56064 - “« 
5404040 ESE2D6D6 E4E350300 C9DSCSES *..0 ERNIE TSOOUT. .INIT*# 
SF3CSF1 40404040 O0000000 C1114004 *ERNIE LSE.1 1. ..A. Ms 
440C6E4 DSC3E3SC9 D6DS40D2 C5E840C4 * PROGRAM FUNCTION KEY D-* 
5404011 CiDICS5DS E3C50961 ESCSD9C9 «EFINITION .AJENTER.VERI » 
SEICSDS £240C2C5 DIDGE640 C&D6D940 «FY PARAMETERS BELOW FOR * 
4CSD5C1 D340E6C9 ESCB40F2 F440D7C6 +3278 TERMINAL WITH 24 PFe 
0106007 C6F1I4010 EB7E7E6E 1DC8CB8CS *KEYS..CO..PFI  .Y....HHE* 
7CEFIFS 1DE87E7E 6E10C8C8 C5D3D73C *LP.DV ..PF13.Y....HHELP. 
O1DE87E 7E6E1DC8 E2D7D3C9 E34C3CCS *«£ ..PF2 .Y....HSPLIT .Es 
6FIF41D E87E7E6E 1D0CBE2D7 D3C9E311 «F...PF3 .Y....HEND .GD .»« 
DEB7E7E 6E1DC8CS DSC4403C C7C44011 «*GE.. * 


HEXFORMAT AIO FF FID OO EID EFR2 
TIME 26265 .487905 


O@FED640 C5D9DSC9 
C4DSD5C9 €5404040 
40400709 )6C7D9C1 
6C9D5 C9E3SC9DE6 
B40D7 ¢€1D9C104 
2F7F8 #0E3CS5D9 
2C5E8 E27A11C3S 
73CC4 €5401D60 
0401D §0D7C6F2 
01105 €51060D?7 
O1D60 D7C6F340 
51D60 


£2 


Hex ASCB TSO Job Terminal Flags 
Offset User Name ID 


Figure 46. mvs Example of TGET/TPUT Trace Output 
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The following fields appear in the TGET/TPUT trace. 


The first two bytes in each row show the hex offset in storage. The data follows 
after that. 


Byte 
(hex) Meaning 


00-03  aAscs address 

04-0B Jobname 

OC-—OE C'TSO’ 

OF—11  C’'INn’ for inbound data (TGET); C’ouT’ for outbound data (TPUT) 


12 TGET/TPUT option flags (see the svc 93 description in the Debugging Hand- 
book for bit definitions) 


13. TGET: return code (see the 7SO Guide to Writing a Terminal Monitor 
Program for descriptions) 


TPUT: ; 


X'00' EDIT, ASID, FULLSCREEN, Or CONTROL options. 
X'01' NOEDIT option 
X'02' TPG macro issued 


14-17  C’'lnt’ for the first 228-byte section of a piu; C‘mID’ for the middie sections 
of a Piu; C‘LAST’ for the last section of a PiU | 


18—-1F Tso user ID 

20-27 Symbolic terminal 10 
28-2B Zero 

2C Start of user data. 
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Traces Provided by NCP 


NCP provides several kinds of traces to record the flow of network events. Each 
trace occurs at a different point in the network (see Figure 35 on page 222). This 
allows you to follow an Ru through the network and determine where in the network 
the RU is incorrect. (The RU could be out of sequence or lost, the data in the Ru 
could have been changed, and so forth.) 


The NcP traces are: 


e “Generalized PIU Trace” 

e “Line Trace” on page 246 

e “avs Network Controller Line Trace (3710 Only)” on page 250 

e “Scanner Interface Trace (3720, 3725, and 3745 Only)” on page 251 
e “Transmission Group Trace” on page 252. 


For more information on all service aids for NcP, see the NCP, SSP, and EP Diag- 
nosis Guide. 


Generalized PIU Trace 
The generalized piu trace collects piu trace data collected by the ncP. The resulting 
trace output shows the flow of Pius exchanged between the ncpP and its attached 
resources. This trace is hierarchical when started for a physical unit or a line. 
That is, logical units associated with the physical unit are automatically traced 
when traffic flows to them. Likewise, when the generalized piu trace is started fora 
line, physical units and logical units associated with the line are automatically 
traced when traffic flows to them. When the generalized Piu trace is stopped for a 
physical unit, the trace is reset for all logical units associated with the physical 
unit, regardless of how the generalized Piu trace was started. 


When to Use the Generalized PIU Trace 
Use the generalized piu trace to trace Piu data at the ncP level and to determine 
whether the NcPp has received or sent Piu data. 


Note: VTAM can start a generalized Piu trace only for the resources that it owns. A 
data host, which does not own any NCPs, cannot start a generalized piu trace for an 
NCP or any of the NcP’s subordinate resources. 


Generalized PIU Trace Operation 
Start the generalized Plu trace with the MODIFY TRACE command. For more informa- 
tion on the MODIFY TRACE Command for the generalized Piu trace, see VTAM Opera- 
tion. 


mvs Make sure that GTF (with TRACE = USAR) is active before starting this trace. Use 
TAP with INPUT =GPT to format and print the trace output. 


vm Use cpTRAP (with a format ID of 3D) to collect generalized Piu trace data. Enter 
the ETRACE command, using the GTRACE and GROUP operands. Use TRAPRED or TAP to 
format and print the output. 


vse Use TAP with INPUT=GPT to format and print the trace output. 


For more information on printing trace output, see “Printing Trace Records” on 
page 223. 
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The line trace, a joint function of VTAM and the ncp, records the status of a line each 


time the NcP receives data from or sends data to that line. Although the trace is 


controlled by vTam, the information in the trace records is collected by the ncp. The 
NCP sends the data to VTAM in a Plu. A trace type indicator in the Piu indicates 
whether the trace is a byte line trace (Type 2 scanner) or a block line trace (Type 3 
scanner). 


The line trace records the operating parameters of a line each time a level 2 inter- 
ruption occurs on that line. 


e For a 3705 Communications Controller with a Type 2 communication scanner, a 
level 2 interruption occurs each time a byte of data is sent or received across 
the line. 


¢ For a 3705 Communications Controller with a Type 3 communication scanner, a 
level 2 interruption occurs each time an NcP buffer is filled and the buffer data 
is sent or received across the line. 


¢ For a 3720, 3725, or 3745 Communication Controller, a level 2 interruption 
occurs each time a méssage (an entire Piu) is sent or received. 


You can use the line trace only for lines attached to a communication controller 
and operating in network control mode. 


For each 3705 Communications Controller, as many as eight line traces can be 
active at a time. 


For each 3720, 3725, or 3745 Communication Controller, a combination of eight line 
or scanner interface traces can be active at one time. 


The number of active line traces to be allowed is specified during NCP generation. 
In a cross-domain network in which the communication controller is connected to 
more than one host processor, the number of active traces allowed is distributed 

among the connected host processors on a first-come, first-served basis. 


Note: As the number of active line traces increases, the system becomes less effi- 
cient. | 


When to Use the Line Trace 
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You might use this trace if you suspect a problem with a device attached to a com- 
munication controller. If data appears correctly in the line trace but the terminal or 
printer does not react appropriately, the device itself is probably causing the 
failure. 


Before using a line trace, you should use buffer and 1/0 traces to verify that the 
problem is not in vTAM or an application program. You may also want to use the 
scanner interface trace (for 3720, 3725, and 3745 Communication Controllers only), 
which traces data after it has been processed by the ncP and before it leaves the 
communication controller. Therefore, it can help determine whether the problem is 
in the NCP or in the line. 


Note: VTAM can start a line trace only for the resources that it owns. A data host, 
which does not own any NCPs, cannot start a line trace for an NCP or any of the 
NCP’s subordinate resources. 
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You might want to use a transmission group (TG) trace instead of or in addition to 
this trace. If there is more than one active line in a transmission group, and you do 
not know which line is causing the problem, use the transmission group trace. The 
transmission group trace also shows more data than the line trace. 


Line Trace Operation 
Start the line trace with the MODIFY TRACE command or the TRACE start option. In 
either case, specify TYPE=LINE. For more information on the MODIFY TRACE 
command, see VTAM Operation. For more information on the TRACE start option, 
see VTAM Installation and Resource Definition. 


mvs Make sure that GTF (with TRACE =USR) is active before starting this trace. To 
format and print the line trace: 


e For a 3705, use TAP Or PROMP. For PROMP, specify USR=(LINE) Or USR=(FF2) on the 
EDIT option. 


¢ For a 3720, 3725, or 3745, use TAP with INPUT =LINE Specified. 


vm Use TRAPRED or TAP to format and print the output. 
e For a 3705, use TAP or TRAPRED. For TRAPRED, specify the EFF2 option. 


¢ For a 3720, 3725, or 3745, use TAP with INPUT =LINE specified. 


vse Use TPRINT or TAP to format and print the line trace. 
¢ Fora 3705, use TAP Or TPRINT. For TPRINT, Specify LINE=name or LINE=ALL. 


¢ For a 3720, 3725, or 3745, use TAP with INPUT =LINE specified. 


For more information on printing trace output, see “Printing Trace Records” on 
page 223. 


Line Trace Output (CS Type 2) 
Figure 47 shows an example of line trace output for a 3705 Communications Con- 
troller with a Type 2 communication scanner. This example was created with 
PRDMP, the MVS print utility, but the output looks the same for vm and VSE, except as 
noted below. 


The trace fields are explained after the figure. In addition to the fields described 
here, additional operating-system-dependent fields may appear (in MVS and vm). 
For a description of these fields, see “mvs Fields in VIAM Trace Output” on 
page 225 and “ym VM-Only Fields in VTAM Trace Output” on page 226. 


LINE LINEO1 LRC(000,000) INBOUND ACTIVE RNTIME=1D 
LCD C PCF A TIME 16 SCF 42 PDF D4 LCD C PCF A TIME 16 SCF 42 PDF 40 
LCD C PCF A TIME 16 SCF 42 PDF E5 LCD C PCF A TIME 16 SCF 42 PDF 40 
LCD C PCF A TIME 16 SCF 42 PDF E3 LCD C PCF A TIME 16 SCF 42 PDF 40 
LCD C PCF A TIME 16 SCF 42 PDF C1 LCD C PCF A TIME 16 SCF 42 PDF 40 


Figure 47. Example of Line Trace Output (CS Type 2) 


The following fields appear in the line trace for cs Type 2. 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 Chapter 7. Using VTAM Service Aids 247 


248 VTAM Diagnosis 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


The header portion of the line trace record contains these fields: 


Field Header Field Contents 


LINE The name of the node being traced. In Figure 47, the line name 
iS LINEQ1. 
LRC(xXxx,yyy) The number of records lost since the last trace record was 


written because the trace facility could not get a vTAM buffer. 
xxx is the destination’s lost record count, and yyy is the source’s 
lost record count. 


INBOUND MVS vm The direction of the data with respect to this host. It 
always Says INBOUND because VTAM always receives the trace 
records from the NCP. 


vse This field is replaced by a time stamp. 


ACTIVE The status of the line being traced. In Figure 47, the line status 
is ACTIVE. The line status may also appear as DEACTIVATE or 
SLOWDOWN. 


® ACTIVE means that the line trace is active. 
® DEACTIVATE means that the line trace is not active. 


® SLOWDOWN means that the line trace is not active because the 
NCP is in slowdown mode. 


A status of DEACTIVATE or SLOWDOWN appears only in the last 
record to be sent for that line. It means that no more data will be 
sent until the trace is activated again for that line. 


RNTIME = hh Is a timer field. hh is a hexadecimal value indicating in tenths of 
a second the time at which the communication controller sent 
the completed line trace record to VTAM. This value is taken 
from a timer that is reset to 0 after 25.5 seconds. This value can 
be compared with the TIME value for the first level 2 interruption 
data contained in the second part of the line trace record. This 
comparison shows the elapsed time covered by this trace 
record. Comparing this with the number of level 2 interruptions 
contained in the trace record indicates the oO activity during the 
elapsed time. 


The data portion of the line trace record contains a timer value and values from the 
interface control word (icw) and communication controller hardware registers at 
each level 2 interruption. Each printed line contains up to two sets of data, one for 
each of two level 2 interruptions. For detailed descriptions of these additional 
fields in the line trace records, see the Principles of Operation manual for your 
communication controller and the NCP, SSP, and EP Diagnosis Guide. 
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Field Header Field Contents 


LCD The line control definer (LCD) defines the type of protocol being 
used over the line. The Lco for a line is generally set when the 
NcP is loaded and remains unchanged throughout normal opera- 


tion. | 

PCF The primary control field (PcF) defines the state of the line inter- 
face at any particular time. 

TIME This hexadecimal value indicates, in tenths of a second, the time 


elapsed between level 2 interrupts as they occur on the line 
interface as data is received. Level-two interrupts are repres- 
ented by the data (PDF). The value of this timer is reset to 0 
every 25.5 seconds. 


SCF The secondary control field (SCF) is used as a status and opera- 
tion modifier by the communication scanner and the control 
program. 

PDF The parallel data field (PDF) is used as a character buffer. For a 


transmission, the program places the characters to be sent in 
the PDF, and transmits them to the line interface. For a receive 
operation, the character is assembled, then transferred by hard- 
ware to the PoF. 


Line Trace Output (CS Type 3) 
Figure 48 shows an example of line trace output for a 3705 Communications Con- 
troller with a Type 3 communication scanner. This trace record shows the oper- 
ating status of a line each time an ncp buffer is filled, instead of each time a 
character is transmitted. 


This example was created with PRDMP, the mvs print utility, but the output looks the 
same for vM and VSE, except as noted below. 


The trace fields are explained after the figure. Most fields in this record are similar 
to the last example, but the Type 3 scanner has some additional fields. For more 
detailed descriptions of these additional fields see the Principles of Operation 
manual for your communication controller and the NCP and EP Reference 
Summary and Data Areas. 


LINE LINEO1 LRC(0G0,000) INBOUND ACTIVE RNTIME=1D 
STATUS SCF LCD PCF EPCF STAT1 STAT2 TIME ADDR CNTL IOBLXB DISP ICW CCBLV 
44 9 9 00 00 Ol 80 03 71 30 AA 11 = 1BB2 
TEXT COB4 


Figure 48. Example of Line Trace Output (CS Type 3) 


In addition to several fields shown in the line trace for cs Type 2, the following 
fields appear in the line trace for cs Type 3: 
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Field Header Field Contents 


EPCF The extended primary control field. These bits extend the 
meaning of the PCF. 

STATI Status byte 14 of the icw. 

STAT2 Status byte 15 of the icw. 


elapsed between level 2 interrupts as they occur on the line 
interface as data is received. Level-two interrupts are repres- 
ented by the data. The value of this timer is reset to 0 every 25.5 


seconds. 

ADDR The SDLc frame address field. 

CNTL The sptc frame control field. 

lOBLXB The 1-byte command field from the !0B/LxB control block. 

DISP Or XDISP MVS VM DISP Or vse XDISP is byte 0 from the communication 
scanner display register. 

lOW Byte 13 of the interface control word. 

CCBLV or LVL2 MVS VM CCBLV Or vsE LVL2 is the address of the level 2 interruption 
processor routine, taken from field CCBL2 in the NCP CCB control 
block. 

TEXT The contents of the NcP buffer being transmitted in both 


hexadecimal and EBCDIC. 


uvs Network Controller Line Trace (3710 Only) 


The network controller line trace traces SDLC, BSC, and START/STOP data link control 
frames sent or received by an IBM 3710 Network Controller. 


The 3710 physical unit provides a network controller line trace on a physical unit 
type 2 node. The network controller line trace traces data link control (DLC) proto- 
cols, such as DLC frames exchanged between a network controller and an NCP, or 
DLC frames exchanged between a network controller and a control unit. 


The network controller line trace facility also traces the synchronous data link 
control (SDLC), binary synchronous control (BSC), and start/stop DLC frames that are 
sent or received by a line adapter. 


When tracing an SDLC or BSC line, you can choose to trace all the frames (control 
and data) or just the data frames. All frames are traced on a start/stop line. 


mvs When to Use the Network Controller Line Trace 
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Run this trace if you have an incorrect output problem, a performance problem, or 
you suspect a network controller problem. 
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mvs Network Controller Line Trace Operation 
Start the network controller line trace with the MODIFY TRACE command. For more 
information on the MODIFY TRACE command for the network controller line trace, see 
VTAM Operation. 


Active traces stop if: 


¢ The network controller is reset (for example, during a failure or a configuration 
load) 


¢ The network controller enters slowdown (shown in the header of the RECTRD RU) 
e The line fails during the trace. 


If the network controller recovers after a failure, and it is not the only one on the 
line, the trace will resume. 


Make sure that GTF is active before you start this trace. Use TAP with NETCTLR speci- 
fied to format and print the output. 


For more information on printing trace output, see “Printing Trace Records” on 
page 223. 


mvs Network Controller Line Trace Output 
VTAM receives the trace data from a network controller in a series of RECTRD RUS, 
which are put into trace records. These records are passed to GTF, which stores 
them in a trace output data set, SYS1.TRACE. Use TaP to print the trace output. 


Scanner Interface Trace (3720, 3725, and 3745 Only) 


The scanner interface trace, a joint function of VTAM and the ncp, records the oper- 
ating parameters of a line whenever a 3720, 3725, or 3745 Communication Con- 
troller sends or receives a message. Although the trace is controlled by vTAM, the 
information in the trace records is collected by the ncPp. The scanner interface 
trace records the operating status of a line whenever the communication controller 
sends or receives a message (PIU). 


When you start the trace, you can choose how many bytes of data you want to 
trace. The default is the entire Piu. You can only use the scanner interface trace 
on lines operating in network control mode. 


For each communication controller, a combination of eight line traces or scanner 
interface traces can be active at atime. The number of active scanner interface 
traces to be allowed is specified during NCP generation. In a multisystem network 
in which the communication controller is connected to more than one host 
processor, the number of active traces allowed Is distributed among the connected 
host processors on a first-come, first-served basis. 


Note: As the number of active scanner interface traces increases, the system 
becomes less efficient. 
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When to Use the Scanner Interface Trace 


Use the scanner interface trace to determine whether the NCP or a line is causing a 
problem. The scanner interface trace records inbound data before the NCP proc- 
esses it, and records outbound data after the NcP processes it. Therefore, if out- 
bound data is correct in a scanner interface trace, but the device does not react 
properly, the problem is in either the line or the device. 


Scanner Interface Trace Operation 


Start the scanner interface trace with the MODIFY TRACE command or the TRACE start 
option. 


The COUNT option allows you to choose how many bytes of data you want traced (0 
to 254 or ALL). The default is the entire Plu. 


For more information on the MODIFY command for the scanner interface trace, see 
VTAM Operation. For more information on the TRACE start option, see VTAM Instal- 
lation and Resource Definition. 


MVS Make sure that GTF (with TRACE=USR) is active before starting this trace. Use 
TAP With INPUT =LINE to format and print the output. 


VM Use cpTRaAP (with a format !0 of 3D) to collect scanner interface trace data. Enter 
the ETRACE command, using the GTRACE and GROUP Operands. Use TRAPRED or TAP to 
format and print the output. 


VSE Use TAP to format and print the output. 


For more information on printing trace output, see “Printing Trace Records” on 
page 223. 


Transmission Group Trace 


The transmission group trace, a joint function of VTAM and the NcpP, records the 
sequence of Pius being sent through a transmission group. The transmission group 
trace shows Plu traffic on a transmission group as if the transmission group were a 
single line. The sequence of Pius traced is the sequence of their entry to and exit 
from the transmission group, not the sequence of actual transmission along the 
physical lines in the transmission group. The line trace shows the sequence of Pius 
transmitted and received on a physical line. 


When to Use the Transmission Group Trace 


252 VTAM Diagnosis 


Use the transmission group trace instead of a line trace if your failure is restricted 
to sessions using a specific transmission group and you have more than one active 
line in aTG. 


Note: vTAM can start a transmission group trace only for the resources that it owns. 
A data host, which does not own any NCPS, cannot start a transmission group trace. 
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Transmission Group Trace Operation 
Start the transmission group trace with the MODIFY TRACE command. The name 
specified in the ID operand is the line “associated” with the transmission group 
trace. 


The trace is started for the transmission group in which the specified line resides. 
This line and its associated link station must be active before the transmission 
group trace is started. 


lf a line trace is already active for the chosen line within a transmission group, you 
must stop it before starting a transmission group trace. 


Once activated, the transmission group trace remains active until one of the fol- 
lowing occurs: 


¢ The operator stops the trace. 

e The associated line or link station is deactivated or fails. 
¢ The NCP goes through Auto Network Shutdown. 

¢ The NCP goes into slowdown mode. 


If the transmission group trace is ended because the associated line or link station 
fails or is deactivated, the operator can restart it by issuing the MODIFY command 
for another line in the Ta. 


For more information on the MODIFY TRACE command for the transmission group 
trace, see VTAM Operation. 


MVS GTF (with TRACE=USR) must be active to use this trace. Use PRDMP or TAP to 
format and print these trace records. For PRDMP, specify USR=(LINE) Or USR=(FF2) on 
the EDIT option. For TAP specify INPUT = LINE. 

VM Use cpTRAP (with a format ID of 3D) to collect transmission group trace data. 
Enter the ETRACE Command, using the GTRACE and GROUP operands. Use TRAPRED or 
TAP to format and print the output. 


VSE Use TPRINT or TAP. 


For more information on printing trace output, see “Printing Trace Records” on 
page 223. 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 Chapter 7. Using VTAM Service Aids 253 


Transmission Group Trace Output 


254 ~=VTAM Diagnosis 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


MVS VM Figure 49 is an example of transmission group trace records. 


VSE Figure 50 on page 255 is an example of transmission group trace records. 


The trace fields are explained after each figure. In addition to the fields described 
here, additional operating system dependent fields may appear (in MVS and vM). 
For a description of these fields, see “MVS Fields in VTAM Trace Output” on 

page 225 and "VM VM-Only Fields in VTAM Trace Output” on page 226. 


LINE  LINE23 


LRC(000,000) INBOUND ACTIVE RNTIME=00 


TEXT 42000000 2000009A 00000004 QODODO0C DEDQ0DOB 
0005808D OOOACB80 O0AD 

TEXT 6E000000 FOODDO9A 00000004 00000001 00000000 
00000032 20000000 00000823 00000000 G0000000 
00000123 00000040 


Figure 49. MVS VM Example of Transmission Group Trace Output 


The following fields appear in the transmission group trace for MVS and VM: 


Field Header 


LINE /iInename 


LAC(Xxx, yyy) 


INBOUND 


ACTIVE 


Meaning 


The name of the line “associated” with the transmission group 
trace. This line name was specified in the MODIFY TRACE 
command that started the transmission group trace. 


The number of records lost since the last trace record was 
written because the trace facility could not get a vTAM buffer. 

xxx is the destination’s lost record count, and yyy is the source’s 
lost record count. 


The direction of the data with respect to this host. It always says 
INBOUND because the data is always received from the NCP. 


The status of the line being traced. In Figure 49, the line status 
is ACTIVE. The line status may also appear aS DEACTIVATE or 
SLOWDOWN. 


¢ ACTIVE means that the line trace is active. 
® DEACTIVATE means that the line trace is not active. 


® SLOWDOWN means that the line trace is not active because the 
NCP is in slowdown mode. 


A status of DEACTIVATE or SLOWDOWN appears only in the last 
record to be sent for that line. It means that no more data will be 
sent until the trace is activated again for that line. 
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Field Header Meaning 


RNTIME = Ah Is a timer field, where hh is a hexadecimal value indicating, in 
tenths of a second, the time at which the communication con- 
troller sent the completed line trace record to vTAM. This value 
is taken from a timer that is reset to 0 every 25.5 seconds. This 
value can be compared with the TIME value for the first level 2 
interruption data contained in the second part of the line trace 
record. This comparison shows the elapsed time covered by 
this trace record. Comparing this with the number of level 2 
interruptions contained in the trace record indicates the i/o 
activity during the elapsed time. 


TEXT Shows the TH and RAH for each plu that traversed the data path 
through the transmission group. If the piu is for data flow 
control, session control, or network control, the full RU portion of 
the PiU is also included in the trace record. The RU may contain 
sense data. If the PiU is function management data (FMD) and 
contains an FM header, six bytes of the RU are included in the 
transmission group trace record. If an FMD PIU without an FM 
header is traced, the RU is not included. 


LINE LINE23 87.150/09:15:06.18 ACTIVE RNTIME=00 

TEXT 42000000 2000009A 00000004 OQODDODDOC OEDOODOB 0005808D OOOACB80 DOA00000 
00000032 20000000 00050101 Q000000B 0040 

TEXT 6E000000 FOOQOOD9A 00000004 00000001 00000000 0005808D OOOACB80 O0AD0000 
00000123 00000040 00050101 0000000B 0000 


Figure 50. VSE Example of Transmission Group Trace Output 


The following fields appear in the transmission group trace for vSE: 


Field Header Meaning 


LINE /inename Is the name of the line associated with the transmission 
group trace. This line name was specified in the MODIFY 
TRACE command that started the transmission group trace. 


yy.jjj//Ah:mm:ss.hh Is the year (yy), the Julian date (jjj), and the time to hun- 
dredths of a second (hh:mm:ss.hh) that trace record was 
written. 


To find this field in Figure 50, look for “87.150/09:15:06.18” 
in the first trace record. 


LRC(xXxx, yyy) Is the number of records lost since the last trace record 
was written because of the inability of the trace facility to 
get VTAM buffers. xxx is the destination’s lost record count, 
and yyy is the source’s lost record count. This field is not 
present in the trace record unless records are lost. 
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TRANSMIT Of RECEIVE 


ACTIVE 


RNTIME = hh 


TEXT 
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Meaning 


Indicates, for full-duplex tines, the side of the line used for 
the transmission. 


The status of the line being traced. In Figure 50, the line 
status is ACTive. The line status may also appear as DEACTI- 
VATE Or SLOWDOWN. 


¢ ACTIVE means that the line trace is active. 
® DEACTIVATE means that the line trace is not active. 


*¢ SLOWDOWN means that the line trace is not active 
because the ncpP is in slowdown mode. 


A status of DEACTIVATE or SLOWDOWN appears only in the last 
record to be sent for that line. It means that no more data 
will be sent until the trace is activated again for that line. 


Is a timer field, where hh is a hexadecimal value indi- 
cating, in tenths of a second, the time at which the commu- 
nication controller sent the completed line trace record to 
VTAM. This value is taken from a timer that wraps around to 
0 after 25.5 seconds. This value can be compared with the 
TIME value for the first level 2 interruption data contained in 
the second part of the line trace record. This comparison 
will show the elapsed time covered by this trace record. 
Comparing this with the number of level 2 interruptions 
contained in the trace record indicates the vo activity 
during the elapsed time. 


Shows the TH and RH for each Plu that traversed the data 
path through the transmission group. If the piu is data flow 
control, session control, or network control, the full RU 
portion of the piu is also included in the trace record. The 
RU may contain sense data. If the PiU is function manage- 
ment data (FMO) and contains an Fm header, six bytes of the 
AU are included in the transmission group trace record. If 
an FMD PiU without an FM header is traced, the Ru is not 
included. 
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vss Dynamic Trace Utility for Communication Adapters 


This trace facility of vSE applies to the 4361 communication adapter, and to the 9370 
telecommunications subsystem. It can record communication adapter line traces 
on tape while the line and the communication adapter are both active. It can also 
print selected trace entries after a line-related error has occurred. 


The communication adapter line trace should be used when line-related errors are 
suspected on lines attached to the communication adapter, for example: 


¢ Frequent unexplained line outages 
e Unusual sense or status in 1/0 error messages 
e Device outages that cannot be explained with I/o or buffer traces. 


For more information on using this trace facility, see the VSE Service Aids manual. 


Operator Commands 


You can control and monitor the vTAm network with both predefined specifications 
(start options) and operator commands. These commands include the DISPLAY 
command and the MODIFY command. 


® DISPLAY 
— “Display Buffer Pool Use” on page 258 
— “Display NCP Storage” on page 263 
— “Display Network Status” on page 263 
— “Display Route Status” on page 265 
— “Display Route Test” on page 266. 
® MODIFY 
— “Modify Input/Output Problem Determination” on page 270 
— “Modify Message Module Identification” on page 270 
— “Modify NCP Intensive Mode Recording” on page 271 
— “Modify SDLC Link Level 2 Test” on page 271 
— “Modify Tuning Statistics” on page 272. 
¢ For more information on problem determination, see the other parts of this 
chapter or the table of contents. 
For information on vTAM Start options, see VTAM Installation and Resource Defi- 
nition. For information on commands, see VTAM Operation. 


Note: Several other licensed IBM programs can also be used to monitor and collect 
error statistics from the VTAM network: the NetView program, NCCF, NPDA, and NLDM. 
The Network Program Products General Information manual describes these 
licensed programs. 
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Display Buffer Pool Use 


You can use the DISPLAY BFRUSE Command to display information about buffer use. 
In response to this command, VTAM indicates that the display is for buffer use and 
issues a series of messages that contain monitoring information. For each buffer 
pool, this information includes: 


¢ Buffer pool ip 


¢ Flags (Q or F): Q shows a request is queued for this pool; F shows dynamic 
buffering has failed for this pool 


e Size of each buffer in this pool 

¢ Current total number of buffers in this pool 

e Current count of buffers available (the number not in use) 

e Largest number of buffers this pool has expanded to at any time 

e Largest number of buffers in use at any time 

¢ Cumulative count of the number of times each buffer pool has expanded 
e Expansion and contraction thresholds 


¢ The expansion increment (the number of buffers to be added to a buffer pool 
during dynamic expansion) 


* VTAM’S intermediate routing node buffer use limit (IRNLIMIT), current buffer use, 
and maximum buffer use 


¢ MVS VM VTAM’S CSA buffer use limit (CSALIMIT), current buffer use, and maximum 
buffer use 


¢ MVS VM Maximum amount of CSA in use since VTAM was started. 
lf the DISPLAY BFRUSE Command is used while an Sms (buffer use) trace is running, 
the fields MAX TOTAL, MAX USED, and TIMES ExP reflects buffer usage only since the 


last trace record was written, because the SMS trace resets these fields. 


For more information about the DISPLAY BFRUSE Command, see VTAM Operation. 


mvs vM Sample Output 


258  VTAM Diagnosis 


Figure 51 0n page 259 and Figure 52 on page 260 are examples of the output 
from a DISPLAY BFRUSE Command in MVS and vo. 


For example, in Figure 51, for the buffer pool with 10 io00, each buffer has 183 
bytes, 200 buffers are currently in the pool, and 166 of those are available. The 
largest number of buffers the pool has ever contained is 200, and the maximum 
ever used at one time is 49. The buffer pool has not been expanded. 


If the number of available buffers drops to 5 (the expansion threshold in this 
example), VTAM expands the pool by adding 20 buffers (the expansion increment). 

If the number of available buffers reaches the contraction threshold, vTAM frees 
buffers (in pages) until the number of buffers in the pool is less than the contraction 
threshold. vTAM frees buffers only if there is a full page in which none of the buffers 
is being used. 


An N/A (not applicable) in the expansion/contraction column indicates that the user 
did not set an expansion increment. 
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If dashes (----- ) appear in place of the contraction threshold, the buffer pool is not 
currently expanded (although it might have been expanded previously). 


IST350I1 VTAM DISPLAY - DOMAIN TYPE = BUFFER POOL DATA 
IST632I BUFF BUFF CURR CURR MAX MAX TIMES EXP/CONT EXP 
IST6331. = ID SIZE TOTAL AVAIL TOTAL USED EXP THRESHOLD ~=INCR 


IST3561 [1000 00183 00200 00166 00200 00049 00000 00005/----- 00020 
IST3561 LPOO 01344 00016 00013 00016 00006 00000 00001/----- 00003 
IST356I1 WPOQ 00184 00350 00344 00350 00006 00000 00001/----- 00020 
IST356I1 LFOQ 00068 00048 00042 00048 00006 00001 00001/00093 00046 
IST3561 CRPL 00116 00500 00497 00500 00004 00000 00004/----- 00030 
IST3561 SFOO 90064 00051 00051 00051 00000 00000 00001/----- 00051 
IST356I SPOO 00112 00002 00002 00002 00000 0000 00001/----- 00032 


IST449I CSALIMIT = NOLIMIT, CURRENT = 0001887K, MAXIMUM = Q001887K 
IST4491 MAXIMUM CSA USED = 0001887K 

IST595I IRNLIMIT = NOLIMIT, CURRENT = QO0Q000K, MAXIMUM = QO0Q0000K 
IST3141_ END 


Figure 51. MVS VMExample of DISPLAY BFRUSE Output for VTAM Pre-V3R2 
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TST3501 VTAM DISPLAY - DOMAIN TYPE = BUFFER POOL DATA 
IST9201I 1000 Q F BUFF SiZE 0123456789 EXP INCREMENT 01234 


IST9211 TIMES EXP 0123456789 EXP/CONT THRESH 012345/6789 
TST922] CURR TOTAL 0123456789 CURR AVAILABLE 0123456789 
IST9231 MAX TOTAL 0123456789 MAX USED 0123456789 
IST924] ----------------------------------------------------------- 
IST920I LPOO Q F BUFF SIZE 0123456789 EXP INCREMENT 01234 
IST9211 TIMES EXP 0123456789 EXP/CONT THRESH 012345/6789 
IST922] CURR TOTAL 0123456789 CURR AVAILABLE 0123456789 
IST9231 MAX TOTAL 0123456789 MAX USED 0123456789 
IST924] ----------------------------------------------------------- 
IST9201 WPOQO Q F BUFF SIZE 0123456789 EXP INCREMENT 01234 
IST921] TIMES EXP 0123456789 EXP/CONT THRESH  012345/6789 
IST9221 CURR TOTAL 0123456789 CURR AVAILABLE 0123456789 
IST9231 MAX TOTAL 0123456789 MAX USED 0123456789 
IST924] ----------------------------------------------------------- 
IST9201 LFOO Q F BUFF SIZE 0123456789 EXP INCREMENT 01234 
IST9211 TIMES EXP 0123456789 EXP/CONT THRESH 012345/6789 
IST9221 CURR TOTAL 0123456789 CURR AVAILABLE 0123456789 
IST923] MAX TOTAL 0123456789 MAX USED 0123456789 
IST9241 ----------------------------------------------------------- 
IST9201 CRPL Q F BUFF SIZE 0123456789 EXP INCREMENT 01234 
IST9211 TIMES EXP 0123456789 EXP/CONT THRESH 012345/6789 
IST922] CURR TOTAL 0123456789 CURR AVAILABLE 0123456789 
IST923] MAX TOTAL 0123456789 MAX USED 0123456789 
IST924] ----------------------------------------------------------- 
IST9201 SFOO Q F BUFF SIZE 0123456789 EXP INCREMENT 01234 
IST9211 TIMES EXP 0123456789 EXP/CONT THRESH 012345/6789 
S1922i CURR TOTAL 0123456789 CURR AVAILABLE 0123456789 
IST9231 MAX TOTAL 0123456789 MAX USED 0123456789 
IST924] ----------------------------------------------------------- 
IST9201 SPOO Q F BUFF SIZE 0123456789 EXP INCREMENT 01234 
IST9211 TIMES EXP 0123456789 EXP/CONT THRESH 012345/6789 
IST922] CURR TOTAL 0123456789 CURR AVAILABLE 0123456789 
IST9231 MAX TOTAL 0123456789 MAX USED 0123456789 
IST9241 ----------------------------------------------------------- 


IST3141 END 
Figure 52. MVS VM Example of DISPLAY BFRUSE Output for VTAM V3R2 
DISPLAY BFRUSE output can help you identify possible sources of problems. The fol- 


lowing chart shows some problem symptoms and the corresponding buffers to 
check in SMS trace output: 


For this symptom: Check this buffer pool: 
0 hang lOBUF 

session failure CRPLBUF and LPBUF 
VTAM hang LPBUF 
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vse Sample Output 
Figure 53 and Figure 54 0n page 262 are examples of the output of a DISPLAY 
BFRUSE Command in VSE. 


For example, in Figure 53, for the buffer pool with IO LF, each buffer has 407 bytes, 
92 buffers are currently in the pool, and 54 of those are available. The most buffers 
the pool has ever contained is 140, and the maximum ever used at one time is 127. 
The buffer pool has been expanded 24 times. 


lf the number of available buffers equals 7, VTAmM will expand the pool by adding 12 
buffers. If the number of available buffers becomes greater than 31, VTAM will 
attempt to free enough of the extents to reduce the number of available buffers 
below 31 (provided these buffers are on the same page or pages). 


An N/A (not applicable) in the expansion/contraction column indicates that the user 
did not set an expansion increment. 


If dashes (----- ) appear in place of the contraction threshold, the buffer pool is not 
currently expanded (although it might have been expanded previously). 


5D501 VTAM DISPLAY - DOMAIN TYPE = BUFFER POOL DATA 
5G32] BUFF BUFF CURR CURR MAX MAX TIMES EXP /CONT EXP 
56331 ID SIZE TOTAL AVAIL TOTAL USED EXP THRESHOLD ~=INCR 


50561 VF 02048 00020P 00008P N/A 00012P N/A N/A N/A 
50561 VP 02048 00512P O0170P N/A O0456P N/A N/A N/A 
50561 SF 00356 00022 00020 00022 00016 60000 00003/----- 90005 
50561 LF 00407 00092 00054 00140 00127 00024 00007/00031 00012 
5D561 SP 00112 00022 00022 09022 00000 00000 00003/----- 00017 
50561 LP 01016 00013 00009 00015 00001 00001 00003/00007 00002 
50561 WP 00160 00075 00074 00135 00004 90004 00003/----- 00012 
5F95I IRNLIMIT = NOLIMIT, CURRENT = 0000000K, MAXIMUM = QQ0Q000K 
50141 END 


Figure 53. VSE Example of DISPLAY BFRUSE Output for VTAM Pre-V3R2 
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IST350I1 VTAM DISPLAY - DOMAIN TYPE = BUFFER POOL DATA 

IST920I VF QF BUFF SIZE 0123456789 EXP INCREMENT 01234 
1ST9211 TIMES EXP ****N/A*** EXP/CONT THRESH 9 *****N/A**> 
1$T9221 CURR TOTAL 0123456789P CURR AVAILABLE  0123456789P 
1$T9231 MAX TOTAL ****N/A*** MAX USED 0123456789P 
BST O24 eed citesiied hee toree staan ee epee ee Sate 
IST9201 VP QF BUFF SIZE 0123456789 EXP INCREMENT 01234 
1$T9211 TIMES EXP ****N/A*** EXP/CONT THRESH 9 *****N/At#* 
1ST922] CURR TOTAL 0123456789P CURR AVAILABLE  0123456789P 
1$T9231 MAX TOTAL ****N/A*** MAX USED 0123456789P 
DSO 200: eclectic eee eee ee enact 
IST9201 SF QF BUFF SIZE 0123456789 EXP INCREMENT 01234 
1ST9211 TIMES EXP 0123456789 EXP/CONT THRESH  012345/6789 
1$T922] CURR TOTAL 0123456789 CURR AVAILABLE 0123456789 
1ST9231 MAX TOTAL 0123456789 MAX USED 0123456789 
1510201 eee a eaters at ees 
IST9201 LF QF BUFF SIZE 0123456789 EXP INCREMENT 01234 
1ST9211 TIMES EXP 0123456789 EXP/CONT THRESH  012345/6789 
1879221 CURR TOTAL 0123456789 CURR AVAILABLE 0123456789 
1ST9231 MAX TOTAL 0123456789 MAX USED 0123456789 
TS 10201 “asereecsee ese oeos See sda se osetia net es tesocuasacamaus. 
IST9201 SP QF BUFF SIZE 0123456789 EXP INCREMENT 01234 
IST9211 TIMES EXP 0123456789 EXP/CONT THRESH  012345/6789 
1ST9221 CURR TOTAL 0123456789 CURR AVAILABLE 0123456789 
1ST9231 MAX TOTAL 0123456789 MAX USED 0123456789 
ISI929T taeo sate ce ceeten soe see eee ada Se eee oer sebaess 
IST9201 LP QF BUFF SIZE 0123456789 EXP INCREMENT 01234 
1ST9211 TIMES EXP 0123456789 EXP/CONT THRESH 012345/6789 
1ST9221 CURR TOTAL 0123456789 CURR AVAILABLE 0123456789 
1ST9231 MAX TOTAL 0123456789 MAX USED 0123456789 
TS19241: teeteedites Sons Sener eesoncs case desc eu te ascaweetee eeeceeasd 
IST920I WP Q F BUFF SIZE 0123456789 EXP INCREMENT 01234 
IST9211 TIMES EXP 0123456789 EXP/CONT THRESH 012345/6789 
1ST9221 CURR TOTAL 0123456789 CURR AVAILABLE 0123456789 
1ST9231 MAX TOTAL 0123456789 MAX USED 0123456789 
PS 19241 sieceew ecient ac ean eeebe ees eee a Sie tet eee take Seba ose 


TST595I IRNLIMIT = NOLIMIT, 


IST3141 END 


CURRENT = 0000000, MAXIMUM = 0000000 


Figure 54. vSEExample of DISPLAY BFRUSE Output for VTAM V3R2 


DISPLAY BFRUSE Output can help you identify possible sources of problems. The fol- 
lowing chart shows some problem symptoms and the corresponding buffers to 
check in SMS trace output: 


For this symptom: Check this buffer pool: 


vO hang LFBUF 
Session failure LPBUF 
VTAM hang LPBUF 
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Display NCP Storage 
You can dynamically request and display any selected portion of NCP storage by 
using a DISPLAY NCPSTOR command. Up to 256 bytes can be displayed for each 
command. For the 3720 or 3745 communication controller, you can use the DISPLAY 
NCPSTOR Command to display up to 256 bytes of an NcP dump or state vector stored 
on the disk. 


VTAM issues message IST2451 (or 5C45!, for VTAM V3R1 Or V3R1.2 running under VSE) to 
display the storage contents. 


Notes: 


1. The NcP storage to be displayed may change while it is being formatted for 
transmission. 


2. You cannot display NcP storage at a data host, because a data host does not 
own any NCPs. 


For more information on the DISPLAY NCPSTOR command, see VTAM Operation. 


Display Network Status 
You can use the DISPLAY command to display status information about the vTAM 
network. For example, a request for DISPLAY of a physical unit or of a logical unit 
indicates whether that node has been added by dynamic reconfiguration. DISPLAY 
also indicates whether a logical unit, a physical unit, or a link is supported by the 
Network Termina! Option (NTO). 


Note: From a data host you cannot display the status of either an NcP or the NcP’s 
subordinate resources, because a data host does not own any NCPs. 


Two types of node status are displayed when you use the DISPLAY command: The 
STATUS field shows the current state of the node; the DESIRED STATE field shows the 
desired state. Both states are taken from the ROTE for the node. 


The desired state is the condition that vTAM processing is attempting to establish 
for the node. Previously entered operator commands or recovery processing may 
establish the desired state for a node. When processing is completed, the desired 
state and the current state should be equal. See VTAM Messages and Codes for 
descriptions of the resource status codes used in response to the DISPLAY 
command. 
The DISPLAY command displays the status of the following: 

¢ Any or all application programs 

e Any or all host physical units 

e Any or all active major nodes 


e¢ An NCP in a channel- or link-attached communication controller 


e A channel-attachment (CA) major node and its subordinate links and link 
Stations 


e Any or all lines and the traces associated with them. This display includes the 
line control for each line. 


e Any or all line groups 
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Any or all cross-subarea link stations 

Any or all physical units or Bsc cluster controllers 
Any or all logical units 

Any or all LU-LU Session states 


Routes used to access other subareas (which are defined by active path defi- 
nitions) 


Any or all cross-domain resource managers (CDRMs). 
Any or all cross-domain resources (CDRSCs) 
MVS VSE The adjacent sscps that can be used on a path to a given destination 


MvS Any or all TSO users, by user identification. This display indicates whether 
the TGET/TPUT trace is active for a TSO user. 


mvs vM Displays for SNA Network Interconnection 
If SNA network interconnection is in use, the DISPLAY command shows: 


Trace Status 


264  ~VTAM Diagnosis 


The network ID associated with a resource (if any) 
For a cross-network CDRSC, the real resource name. 


For a cross-network CDRM, the real name of the gateway node through which 
the SSCP-SSCP Session passes, and the network address as known in the 
requesting host’s network. 


The DISPLAY command also shows a 5-character resource status code (xxxxx) for 
the transmission group trace, SIT trace, generalized Piu trace, or network controller 
line trace when applicable. 


Line trace status, transmission group trace status, and SIT trace status are part 
of the response to the DISPLAY ID=/inename command. They appear in the 
messages shown in the following example. 


Note: In this example, both the istxxx! and 5xxxI| message IDSs are shown. (Mes- 
sages beginning with the number 5 pertain only to VTAM V3RA1 Or V3R1.2 running 
under VSE.) In the actual output only one of these message IDs will appear, 
according to the operating system used. 


V3R1 & 
MVS VM V3R1.2 
V3R2 VSE VSE 
IST655] 5F55I LINE TRACE STATUS=xxxxx TG TRACE STATUS=xxxxx 
IST588I 5E88I SIT TRACE STATUS=xxxxx 


Generalized Plu trace status is part of the the response to the DISPLAY 
ID = nodename command. It appears in the messages shown in the following 
example. 


Note: In this example. both the !stxxx!i and 5xxxIl message IDs are shown. (Mes- 
sages beginning with the number 5 pertain only to VTAM V3A1 Or V3R1.2 running 
under VSE.) In the actual output only one of these message IDs will appear, 
according to the operating system used. 
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V3R1 & 
MVS VM V3R1.2 
V3R2 VSE VSE 
IST7521 =5H52I) «GPT TRACE STATUS=xxxxx 


e mvs The status of the network controller line trace is part of the response to the 
DISPLAY TRACES command. This command tells you if a 3710 network controller 
is tracing and gives you the names of the resources being traced. The status 
appears in this message: 


IST838I TRACE STATUS DISPLAY FOR ID=network controller name 


IST839I PU NAME DOWNSTREAM LINE NAME 
IST840I nnnnnnnl nnnnnnn2 
IST840I nnnnnnnl nnnnnnn2 


TST3141 END 


For more information about the DISPLAY command and the status it displays, see 
VTAM Operation. 


See VTAM Messages and Codes for more information on resource status codes. 


Display Route Status 
The DISPLAY ROUTE command shows the status and availability of virtual and explicit 
routes. For more information on the DISPLAY ROUTE command, see VIAM Operation. 


VTAM displays the status of selected routes and, if TEST=YES is specified, does a 
route test on the routes selected in the DISPLAY command. (See “Display Route 
Test” on page 266.) 


The VTAM operator may select the origin of the routes to be displayed or tested. 
The origin may be either a host processor or an NCP. 


The display of status for the routes selected is formatted as shown in Figure 59. 


Note: In this example, both the IsTxxx! and 5xxx! message IDs are shown. (Mes- 
sages beginning with the number 5 pertain only to VTAM V3R1 Or V3R1.2 running 
under vse.) In the actual output only one of these message IDs will appear, 
according to the operating system used. 


V3R1 & 
MVS VM —s- V3R1.2 
V3R2 VSE VSE 
IST5351  5F35I ROUTE DISPLAY nnn FROM SA sal TO SA sa2 
IST808I 5IO8I ORIGIN PU = origpu DEST PU = destpu 


IST5361 5F36I VR TP STATUS ER ADJSUB STATUS 
IST5371 5F37I~ x y Status Z aaa Status 
TST5371 5F 371 x y status Z aaa Status 


IST314I 5D141 ~~ END 
Figure 55. DISPLAY Route Status 
MVS VM If you are using SNA network interconnection. the DISPLAY ROUTE command 


can be used to show the status and availability of adjacent VTAM networks. The 
resulting display is the same as shown in the previous example, except that 
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message !sTsosi contains an additional field, NETIO=netid, to show the 1D of the adja- 
cent network. See the V7AM Operation manual for information on displaying 
routes in adjacent networks. 


See VTAM Messages and Codes for a complete description of the variable data 
contained in the messages that result from the DISPLAY ROUTE command. 


It is possible for the test results for an explicit route to be lost before they are dis- 
played. For example, if a node or a link along the explicit route fails between the 
time the test request flows outbound and the time the test results flow inbound, the 
results will be lost. If this occurs, re-enter the DISPLAY ROUTE command for that 
explicit route. 


Note: You can use the session monitor of the NetView or NLDM licensed program to 
collect more information about routes. If all the required session monitors or 
NLDMs along the route are in session, you can test the entire route, from one 
session end to the other. For more information, see NetView Operation or NLDM 
Operation. 


Display Route Test 


If a route test was requested, results of the test are sent asynchronously to the 
console of the operator requesting the display. !f the route test failed, the results 
are also sent to the console of the host that owns the rejecting subarea node. If the 
host owning the rejecting subarea is the same host that initiated the route test, that 
host will receive the test results twice. 


To be tested, the explicit route must be known to vTtam. This means the explicit 
route must be defined to VTAM, or must at some time have been operative. 


Successful Route Test 


266 = VTAM Diagnosis 


If TEST= YES is set and the route test is successful, the following asynchronous mes- 
sages follow the route status display messages previously described. 


The test results are formatted as shown in Figure 56. 


Note: In this example, both the istxxx! and 5xxxi message IDs are shown. (Mes- 
sages beginning with the number 5 pertain only to VTAM V3A1 or V3R1.2 running 
under VSE.) In the actual output only one of these message IDs will appear, 
according to the operating system used. 


V3R1 & 
MVS VM V3R1.2 
V3R2 VSE VSE 
IST538I 5F38I ROUTE TEST ### IN PROGRESS 
IST5331 5F33I ER n SUCCEEDED IN ROUTE TEST ### 


IST7971 5H97I FROM VIA ADJACENT DEST ER LENGTH 
IST644I = G44 ftffffff TG aaaaaaaa dddddddd 

IST5341 5341 SSS t XXX yyy it 
IST7981 5F98I nnnn 


Figure 56. Output of a Successfu! Route Test 


in this example, 


¢ 6ffffffff is the name of the origin physical unit 
¢ aaaaaaaa is the adjacent physical unit 
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e dddddddd is the name of the destination physical unit 
e sss is the subarea number of ffffffff 

¢ tis the transmission group number 

e xxx is the subarea number of aaaaaaaa 

e yyy is the subarea of dddddddd 

e tis the explicit route length 

¢ nnnn is the network ID of the node being displayed. 


Failed Route Test 
If the explicit route test fails because vTAM is unable to send the Explicit Route Test 
RU into the network, a message tells why the test cannot be performed. This 
message is shown in the following example. 


Note: In this example, both the istxxx! and 5xxxi message IDs are shown. (Mes- 
sages beginning with the number 5 pertain only to VTAM V3RA1 Or V3R1.2 running 
under vse.) In the actual output only one of these message IDs will appear, 
according to the operating system used. 


V3R1 & 
MVS VM V3R1.2 
V3R2 VSE VSE 
IST5101 5F101 ROUTE TEST ### FAILED - reason 


If the explicit route test is initiated by VTAM but fails, the messages in Figure 57 will 
show the reason for the test failure. 


V3R1 & 
MVS VM V3R1.2 
V3R2 VSE VSE 
IST5331 5F33I ER O FAILED IN ROUTE TEST 8 


IST7971 5SH97I FROM VIA ADJACENT DEST ER LENGTH 
IST6441 3=5G44] fffffttT TG aaaaaaaa dddddddd 

IST5341 = 5 F341 SSS t XXX yyy 

IST7981 5H98I nnnn 

IST5721 5 F721 REJECTING TG ADJACENT ER MASK 
IST816I 5116] rrr g ZZZ minmm 


IST5731 = 5S F731 <ER NOT DEFINED,> 
<A REQUIRED TG IS NOT ACTIVE,> 
<ER NOT REVERSIBLE,> 
<ER EXCEEDS MAXIMUM LENGTH,> 
<UNEXPECTED TYPE BYTE X'##' ,> 


Figure 57. Output of a Failed Route Test 


In this example, 


e 6ffffffff is the name of the physical unit which originated the ER_TEST 
¢ aaaaaaaa is the adjacent physical unit 

¢ dddddddd is the name of the destination physical unit 

e sss is the subarea number of ffffffff 

¢ tis the transmission group number 

¢ xxx is the subarea number of aaaaaaaa 

e yyy is the subarea of dddddddd 

¢ nnnn is the network ID of the node being displayed 

¢ rrris the rejecting subarea 

* zzz is the adjacent subarea 
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¢ mmmm is the explicit route mask 
¢ gis the transmission group number. 


Location of Failure in a Route Test 


268 VTAM Diagnosis 


The variable text in message 573I can help you determine which direction the route 
test was going when it failed. If the reason is “TG NOT ACTIVE” or “MIGRATION,” the 
adjacent subarea follows the rejecting subarea in the route being tested. There- 
fore, the problem is in the adjacent subarea or the link to the adjacent subarea 
from the rejecting subarea. (See Figure 58.) 


Possible 

‘location 

of failure 
=== = SSS SSS 


, 


OUTBOUND 


Rejecting Adjacent 


subarea subarea 


INBOUND 


Direction of Route test ; 


Figure 58. Route Test Failure (TG NOT ACTIVE or MIGRATION) 
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If the reason is “NOT REVERSIBLE,” “MAX ER LENGTH,” or “NOT DEFINED,” the adjacent 
subarea precedes the rejecting node in the route being tested. (See Figure 59.) 


Check to see if the problem is a path definition error. If not, it may be a VTAM error. 


Possible 
location 
of failure 


OUTBOUND 


Rejecting Adjacent 
subarea subarea 


INBOUND 


j Direction of route test 


Figure 59. Route Test Failure (NOT REVERSIBLE, MAX ER LENGTH, or NOT DEFINED) 


The ER MASK field indicates which ER numbers the rejecting subarea can use to 
send data back to the host that requested the test. (These explicit routes are called 
reverse explicit routes.) For example, an ER MASK field of hex 88 (binary 10001000) 
means that the “0” and “4” bits of the mask are turned on, so ER numbers 0 and 4 
can be used to send data back to the host that requested the test. If message 
IST573! Or 5F731 Says an explicit route is “NOT REVERSIBLE”, that means the rejecting 
subarea does not have the reverse explicit routes in its path definitions. 


It is possible for the test results for an explicit route to be lost before they are dis- 
played. For example, if a node or link along the explicit route fails between the 
time VTAM sends the test request and the time vTAM receives the test results, the 
results will be lost. If this occurs, re-enter the DISPLAY ROUTE Command for that 
explicit route. 


See VTAM Messages and Codes for complete explanations of the messages 
resulting from the DISPLAY ROUTE command. 
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Modify Input/Output Problem Determination 


The input/output problem determination (iOPpD) facility detects pending 1/0 oper- 
ations for the SSCP, PUS, NOS, and LUS Components of vTAM, and reports those oper- 
ations to the VTAM operator. These operations are represented by a waiting 
request element (wRE) queued to an I/O locked queue anchor block (LQAB). 


The iopo facility searches the /0 LQAB queues at a user-defined time interval, speci- 
fied with the toINT option. The IoPD facility then writes message pair IST5301/IST532! 
(or 5F301/5F32I1, for VTAM V3R1 Or V3R1.2 running under vSE) for each operation that has 
been pending longer than the specified time interval. 


The message pair includes a 10-character 1/0 operation identifier (usually an RU 
name or operator command), the names of the origin and destination nodes, the 
name of the node for which 1/0 is pending, and the event ID associated with the vo 
operation. 


For more information on event IDs, and for a complete description of message pair 
IST5301/IST5321 (or 5F30I/SF32I), see VTAM Messages and Codes. 


These messages are only an indication that a problem may exist. The longer an 
operation remains pending (for example, the more a message is written for the 
same request unit), the more likely it is that a problem exists. See “Wait 
Procedure” on page 29 for more information on identifying pending I/O problems. 


To use the I0PD facility, use the MODIFY loPD command or the IOINT start option. The 
MODIFY IOPD command is described in VTAM Operation. The \oinT start option is 
described in VTAM Installation and Resource Definition. 


Note: During initialization of a large vTAM network, you may see more pending I/O 
operations than usual. If you are using the !opp facility to track 10 problems 
during initialization, the number of message pairs written can degrade your 
network’s performance. 


You can use the RACNTWRE field of ISTRACON (the VTAM constants module) to 
instruct the !0PD facility to write just one message pair for each type of 
pending I/O operation, rather than one pair for each operation. The resulting 
reduction in the number of messages written can improve your network’s 
performance during initialization. 


See VTAM Customization for a complete description of RACNTWRE and for 
information on using iSTRACON. 


Modify Message Moduie Identification 


270 VTAM Diagnosis 


You can choose to include in VTAM messages the last five characters of the VTAM 
module that issued the message. The module name abbreviation appears between 
the message !D and the beginning of the message text. To insert or delete module 
name abbreviations, use the MODIFY MSGMOD Command or use the MSGMOD start 
option. 


Specifying MSGMOD=NO stops the insertion of module IDs into messages. 
MSGMOD=NO is the default; the issuing module name does not appear in messages 


unless MSGMOD= YES is specified in either the MooIFY command or the MSGMOD start 
option. 
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For more information on the MODIFY MSGMOD command, see VTAM Operation. For 
more information on the MSGMOD START OPTION, see VTAM Installation and Resource 
Definition. 


For example, VTAM message xxxxx (where xxxxx iS an operating system-unique 
message number) normally appears as: 


Xxxxx DUMP OF ncpname COMPLETE 


If MSGMOD= YES were specified in either the MODIFY command or start option, the 
message would appear as: 


xxxxxX INFXI OUMP OF ncpname COMPLETE 


Notes: 


1. Any message that exceeds the maximum message length after the insertion of 
the module ID will be truncated. 


2. tf your installation has changed the message text and omitted the message ID, 
the module name will be the first item in the message. 


Modify NCP Intensive Mode Recording 
When you receive a large number of temporary errors for a Jine, but not enough to 
create a permanent error, you can use intensive mode recording to find the cause 
of the error. 


intensive mode error recording allows each temporary error over a link (and its 
cause) to be recorded and signaled to VTAM. 


Start intensive mode recording with the MODIFY IMR command. For more informa- 
tion on this command, see VAM Operation. 


The MODIFY IMR Command causes the owning sscP to send a request to the ncP. The 
NcP then builds and sends RECMS Rus to the sscp each time an error occurs. The 
sscP writes these error records on the LOGREC or SYSREC file. It may also optionally 
pass them to a user-defined communication network management (CNM) applica- 
tion program. 


Modify SDLC Link Level 2 Test 
Use the SOLC link level 2 test to test an SDLC link between an NcP and a physical unit 
attached on a multipoint line, between two NcPs, or between vTAM and any sec- 
ondary physical unit attached via ICA SDLC lines (vm and VSE only). By running this 
test over an extended time, you can increase the possibility of repeating an inter- 
mittent error that is hard to re-create. 


Note: If you just want to test connectivity to a physical unit, activate the physical 
unit instead of using a link level 2 test. 


To test the link, vTAmM sends test data over the link from the controlling NCP to the 
remote station (NCP or peripheral physical unit). The data is then echoed back to 
the sending ncP. This NcPp then compares the data received with the data sent and 
forwards the results to VTAM. 
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Notes: 


1. For ica-attached devices, VTAM sends test data over the ICA attachment to the 
physical unit. The data is then echoed back to vTAM. 


2. VTAM may also receive an LL2 request from an ICA-attached ncpP, in which case 
VTAM echoes the data back to the ncp. 


When VTAM receives the test results, it sends message IST5491 (or 5F491, for VTAM V3R1 
Or V3R1.2 running under VSE) to the initiating console to indicate how the link level 2 
test ended: data returned without errors, data returned with errors, or no data 
returned because of an inoperative fink or initialization error. See VTAM Mes- 
Sages and Codes for a complete message description. 


When testing the link between an ncp and a peripheral physical unit, the physical 
unit name in the ID operand must be inactive (“dedicated” to the test). Other phys- 
ical units on the same link, however, may remain active. 


When testing the link between two ncpPs, the primary link station is the one named 
in the LL2 command, and the secondary link station is the one responding to the 
test. You must start the test from the primary link station. The primary link station 
must be inactive; the secondary link station must be active; and the link must be 
active. 


Start this test with the MODIFY LL2 command. See VTAM Operation for more infor- 
mation about the MODIFY LL2 command. 


This command causes the sscp to send a test RU to the NcP to which the test ter- 
minal is connected. The NcP returns test results to the requesting sscp in a Record 
Test Results Ru. 


The test results include: 
¢ The number of test frames transmitted by nodename 
¢ The number of test frames received by nodename 


e The number of test frames received without error by nodename (that is, suc- 
cessfully returned by the test station). 


If the above three numbers are not the same, that indicates an error in the link ora 
physical unit. Using a line trace might help you further isolate the problem. 


Modify Tuning Statistics 
To record tuning statistics for VTAM, issue the MODIFY TNSTAT command or use the 
TNSTAT Start option. 


For detailed information about recording tuning statistics and using these statistics 


to improve communication between vTAM and a channel-attached communication 
controller or host processor, see VTAM Customization. 
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Dumps 


The following dumps may be used for problem determination: 
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“Network Control Program (NCP) Dump” on page 274. 


“Communication Scanner Processor (CSP) Dump (3720, 3725, and 3745 Only)” 


on page 277. 


“Maintenance and Operator Subsystem (MOSS) Dump (3720, 3725, and 3745 


Only)" on page 277. 

Mvs Dumps 

— “mvs Abend Dump” on page 284 

— “mvs SNAP Dump” on page 284 

— “Mvs Stand-Alone Dump” on page 284 

— “mvs SVC Dump” on page 284. 

vM Dumps 

— “vM SDUMP Dump” on page 286 

— “vM GDUMP Dump” on page 286 

— “vM DUMP Command” on page 286 

— “vM VMDUMP Command” on page 286. 
vse Dumps 

— “vse Program-initiated Dump” on page 287 
— “vse SDAID Dump Facility” on page 287 

— “vse Stand-Alone Dump Utility” on page 287 
— “vse DUMP Command” on page 287. 
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Network Control Program (NCP) Dump 
You can get either dynamic or static dumps of NcP storage in a communication con- 
troller. 


You can use the DISPLAY NCPSTOR Command (described on page 263) to dynamically 
dump up to 256 bytes of NCP storage. When you request a dynamic dump, VTAM 
sends repeated DISPSTOR Rus to the NcP until the entire contents of NCP storage have 
been transmitted. The NcP continues to operate during this period. As a result, the 
dump represents NCP storage over a period of time. 


You can get a static dump with the vTAm dump facility (for a channel-attached or 
link-attached communication controller). You can also get a static dump with the 
independent dump utility (for a channel-attached communication controller only). 
Figure 60 on page 275 summarizes the methods and requirements for dumping 
the NCP. 


MVS NCP dumps are not allowed on lines or data links (including multipoint subarea 
links) for which IPL=NO was specified in the NcP definition deck. Therefore: 


¢ Code IPL=YES for any line or link which might be used to IPL or dump any 
attached type 4 physical unit. 


e If iPL=YES was not specified for a line with one or more type 4 physical units 
attached, do not try to load or dump over that line. 


Note: If you do not specify a value for IPL, the default is IPL=NO. 


If you have a 3720 or 3745 Communication Controller with a hard disk in your 
network, you can transfer NCP, MOSS, and csP dumps from the communication con- 
troller disk to the host. You can also transfer the ncp load module from the host to 
the disk. If you need to restart the NcP, you can load the Ncp load module from the 
disk. 


Specifically, the following tasks are allowed with the 3720 or 3745 Communication 
Controlier with hard disk: 


¢ You can save the ncP load module to the disk. 

e You can load the NcP load module from the disk. 

e You can transfer an NCP, MOSS, or CSP dump stored on the disk to the host. 

e You can purge an NCP, MOSS, or CSP dump stored on the disk. 

e You can control automatic loading and dumping of the NcP to or from the disk. 
¢ You can display up to 256 bytes of NcP dump or state vector stored on the disk. 


When to Use the NCP Dump 
A dump of the ncP should be taken whenever the Ncp abnormally terminates or 
when an error is Suspected in the NcP. It may be possible to determine that a 
problem exists in the NcP by using the vTAM I/O trace to determine what Plus are 
being sent to and received from the communication controller and by using the NCP 
line trace to determine what is happening on the lines between the communication 
controller and the link-attached logical unit. 
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Using the VTAM Dump Facility 


Method of 
Starting NCP Dump 


MODIFY DUMP 
command, 
OPTION=DYNA 


MODIFY DUMP 
command, 
OPTION=STATIC 


To dump the Ncp, use the MODIFY DUMP command with TYPE=NCP specified. For 
more information on this command, see VJAM Operation. You must execute a 
separate job to print the dump. 


Note: A data host cannot load or dump an Ncp. 


You can use the DUMPDS operand of the MODIFY DUMP command to specify the file 
into which you want the dump transferred. If you omit this operand, VTAM uses the 
file specified on the pccu definition statement for the NCP. 


Note: If you use the same file on the MODIFY DUMP Command as was named on the 
PCCu definition for the NCP, an earlier NCP dump may be overwritten. 


If you omit the DUMPSTA operand, VTAM uses the link station specified on the VARY 
ACT command or the Pccu definition for the NCP, in that order. 


Mvs vM If you are using SNA network interconnection, and you want a gateway NCP 
to perform a dump, you can set its link station name on the DUMPSTA operand only if 
that NcP is in the same network as the host processor requesting the dump. 


If you set AUTODUMP = YES On the Pccu definition statement, a dump is taken automat- 
ically if the NCP abnormally terminates. This dump is written to the dump file 
named on the oumpos option of the pccu definition statement. If AUTOIPL=YES is 
specified on the pccu definition, the NcP is automatically reloaded after the dump is 
taken. With the 3720 or 3745 Communication Controller with hard disk, you can 
specify DUMPLOAD = YES on the VARY ACT command, which automatically stores the 
dump on the disk and loads the Ncp load module from the disk. (For more informa- 
tion about dump commands, see VTAM Operations.) 


Note: For the 3705 only, the NcP is partially overwritten in the communication con- 

troller storage when the dump is taken. If the NCP is running with the partition emu- 
lation program (PEP), the emulation routines are included in the dump and are also 

partially overwritten. The 3705 must be reactivated after the dump is taken. 


Channel or 
Link Attached | Requirements NCP Status Printing Dump 


DUMPDS must Active throughout Execute SSP 
be specified dump, no reacti- dump formatting 
vation required. program IFLDUMP 
(MVS and VM) or 


IFUDUMP (VSE) 


DUMPDS must Deactivated when Execute SSP 

be specified dump is com- dump formatting 
pleted; operator program IFLDUMP 
must reactivate (MVS and VM) or 
the NCP. IFUDUMP (VSE) 


Figure 60 (Part 1 of 2). Dumping the NCP 
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VTAM Error 
Recovery Proce- 
dures (automatic) 


VTAM Error 
Recovery Proce- 
dures (with operator 
intervention) 


SSP independent 
dump utility: 
IFLREAD (MVS and 
VM) or IFUREAD 
(VSE) 


Controller-detected 
error (3720 or 3745 
with disk only) 


Channel 
attached only 


Figure 60 (Part 2 of 2). Dumping the NCP 
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PCCU definition 
requirements: 


DUMPDS must 
be specified 


AUTODMP= YES 
must be speci- 
fied 


AUTOIPL may 
be specified 


PCCU definition 
requirements: 


DUMPDS must 
be specified 


AUTODMP=NO 
must be speci- 
fied 


AUTOIPL may 
be specified 


See the NCP and 
SSP Generation 
and Loading 
Guide for infor- 
mation about 
using inde- 
pendent dump 
utility. 


VARY ACT 
requirements: 


DUMPLOAD= YES 
must be speci- 
fied 


Prior dump must 
have been trans- 
ferred to host 
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Method of Channel or 
Starting NCP Dump Link Attached {| Requirements Printing Dump 


Activated after 
dump is com- 
pleted if 
AUTOIPL= YES 
and restart is suc- 
cessful, or if 
AUTOIPL=NO 
and operator 
requests commu- 
nication controller 
IPL. 


Activated after 
dump is com- 
pleted if 
AUTOIPL= YES 
and restart is suc- 
cessful, or if 
AUTOIPL=NO 
and operator 
requests commu- 
nication controller 
IPL. 


Deallocate com- 
munication con- 
troller from VTAM 
and allocate to the 
independent dump 
utility 


Activated after 
dump is com- 
pleted if 
AUTOIPL= YES 
and restart is suc- 
cessful, or if 
AUTOIPL=NO 
and operator 
requests commu- 
nication controller 
IPL. 


Execute SSP 

dump formatting 
program IFLDUMP 
(MVS and VM) or 
IFUDUMP (VSE) 


Execute SSP 
dump formatting 
program IFLDUMP 
(MVS and VM) or 
IFUDUMP (VSE) 


Done automat- 
ically by IFxXREAD 
using [FxDUMP. 


Execute SSP 
dump formatting 
program I|FLDUMP 
(MVS and VM) or 
IFUDUMP (VSE). 


Transfer to host 
using MODIFY 
DUMP with 
ACTION = 
TRANSFER. 
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Using the Independent Dump Utility (Channel-Attached Controller Only) 


To use the independent ncp dump, the communication controller must be inactive. 
For a description of the job contro! janguage needed to invoke the independent 
dump utility, see the NCP, SSP, and EP Diagnosis Guide. Ncp data areas, registers, 
and codes found in an NcP storage dump are explained in the NCP and EP Refer- 
ence Summary and Data Areas. For more information on the contents of NCP 
storage, see the Principles of Operation manual for your communication controller. 


Note: To use this utility in VSE, a communication controller must be assigned to a 
programmer logical unit for the partition in which it is to run. When the dump is 
complete, you must take away the assignment to make the device available to VTAM 
again. 


Communication Scanner Processor (CSP) Dump (3720, 3725, and 3745 Only) 


The communication scanner processor (CsP) automatically dumps its contents 
when it detects an error. CSP stores the dump on the communication controller 
disk, or on the moss diskette, and the NcP sends an alert message to the host to 
inform it of the error. You can use the MODIFY DUMP command to transfer this dump 
to a dump file in the host processor. 


If you have a 3720 or 3745 Communication Controller with hard disk in your 
network, you can also purge the csP dump from the communication controller 
before sending the dump to the host. 


To transfer the contents of the csp dump, use the MODIFY DUMP command with 
TYPE=CSsP specified. You can use the DUMPDS operand of the MODIFY DUMP Command 
to specify the file into which you want the dump transferred. If you omit this 
operand, the dump is put into one of two dump files: 


¢ The file specified by the CoUmPDs operand of the Pccu definition statement for 
the NCP 


e The file specified by the DUmMPDS operand of the Pccu definition statement for the 
NCP (if COUMPDS was not specified on the Pccu definition). 


After the dump has been transferred to the host, you must then run a separate job 
to print the dump. 


For more information on the MODIFY DUMP Command, see VTAM Operation. 


Maintenance and Operator Subsystem (MOSS) Dump (3720, 3725, and 3745 


Only) 


The maintenance and operator subsystem (moss) automatically dumps its contents 
when it detects an error. moss stores the dump on the communication controller 
disk, or on the moss diskette, and the ncp sends an alert message to the host to 
inform it of the error. You can use the mobiFy DumMP command to transfer this dump 
to a dump file in the host processor. After the dump has been transferred to the 
host, you must then run a separate job to print the dump. 
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To transfer the contents of the MOSS dump, use the MODIFY DUMP command with 
TYPE=MOSS specified. You can use the DUMPDS operand of the MODIFY DUMP 
command to specify the file into which you want the dump transferred. If you omit 
this operand, the dump is put into one of two dump files: 


e The file specified by the mDUMPDS operand of the pccu definition statement for 
the NCP 


¢ The file specified by the DUMPDS operand of the Pccu definition statement for the 
NCP (if MDUMPDS was not specified on the pccu definition). 


For more information on the MODIFY DUMP command, see VTAM Operation. 
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uvs vm Formatting and Printing Dump Output 
The service aids described in this section are available for formatting and printing 
dump output. 


uvs ABDUMP Service Aid 


ABDUMP operates as part of the operating system’s abnormal termination (abend) 
procedure. It automatically formats and prints abend dumps and SNAP dumps. 
(See “mvs Abend Dump” on page 284 and “mys SNAP Dump” on page 284.) 


During ABDUMP processing, VTAM formats control blocks related to the abending 
task and prints them as part of the dump created by ABDUMP. 


ABDUMP formats the control blocks listed below. 


Note: This list is in alphabetical order; the control blocks may be ordered differ- 


ently in a dump. 


Control Block 


Description 


ACDEB VTAM data extent block for the abending task 

APPCB LU 6.2 control block 

COPR Control operator control block associated with the abending task 

CRA Component recovery area for the abending task 

FMCB Function management control block and extensions for the 
abending task 

HSICB Half session information control block for the abending task 

LUCB Logical unit control block associated with the abending task 

MPST Memory process scheduling table for the abending task 

NSICB Logical network services information control block for the 
abending task 

NSSCB Logical network services storage control block for the abending 
task 

PST Process scheduling table for the abending task 

RAB LU 6.2 resource allocation block for the abending task 

ROTE Resource definition table application program entry for the 
abending task 

SAB Logical resource manager session allocation block for the 


abending task 


The following information appears for each control block: 


¢ A header line with the name and hexadecimal address of the beginning of the 


control block. 


e Under the header, the name of each selected field (as it appears in that control 
block’s mapping DSECT) and the contents of the field (listed sequentially). 


e After the formatted printout, a hexadecimal dump of the entire control block. 
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Note: If the vTAm formatted dump routine cannot access a field (either in the 
control block or in the chain of pointers to the control block), a note of the condition 
is made on the dump output. 


See VTAM Data Areas for a description of the fields in each formatted VTAM control 
block. 


vm PRTDUMP Service Aid 


You can format VTAM control blocks from GDUMP output, as follows: 


1. Load the dump with ipcsDUMP and use the PRTDUMP Command to format it or 
print it. (Figure 29 on page 157 shows an example of using PRTOUMP.) VTAM 
asks whether you want VTAM control blocks to be formatted. 


2. Answer yes to format the dump. vTAM then asks about vscs formatting. 
Note: Answering yes provides only the formatted portion of the dump. 
3. Answer no to print the unformatted dump. 


4. Enter the formatting options you want for vScsS. vTAM then asks about VTAM for- 
matting. 


5. Enter the formatting options you want for vTaAm. (The formatting options are the 
same as for VTAMMAP; see page 282). If you request formatting, the VTAM 
control blocks listed below may be formatted, depending on which virtual 
machine was dumped, and which options you selected. 


Note: This list is in alphabetical order; the control blocks may be ordered dif- 
ferently in a dump. 


Control Block Description 

ACDEB VTAM data extent block 

APPCB LU 6.2 control block 

ATCVT VTAM Communication vector table 

BPCB Buffer pool control block 

BPDTY Buffer pool directory 

CONFT VTAM configuration table 

COPR Control operator control block 

CRA Component recovery area (active) 

ERTE Explicit route table entry 

FMCB Function management control block (chained to FMCB exten- 
sions) 

FMCBE FMCB extensions (queued to LUCB) 

FMCBEXT Function management control block extension 

HSCIB Half session information control block 

ITTRC Internal trace table 

LUCB Logical unit control block (chained to ACDEB) 

MPST Memory process scheduling table 

NCB Node control blocks (pointed to by RDTE) 
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uvs PRDMP Service Aid 


NSICB 


NSSCB 


PAGTB 


PST 


PTE 


PXB 


QAB 


RAB 


ROTE 


SAB 


SIB 


SIBIX 


SIBRX 


SIBX 


SPANC 


VRBLK 


WRE With EIDS 


Logical network services information control block 
Logical network services storage control block 
Storage pool page table 

Process scheduling table 

Storage pool page table entry 

Pool expansion blocks (chained to BPCB) 

Queue anchor block for the ROT 

LU 6.2 resource allocation block 

Resource definition table entry 

Logical resource manager session allocation block 
Session information block 

Session information block initiation extension 
Session information block resource extension 
Session information block cross-network extension 
Storage pool anchor block 

Virtual route block 


Waiting request element with event IDS 


The following information appears for each control block: 


e A header line with the name and hexadecimal address of the beginning of 
the control block. 


e Under the header, the name of each selected field (as it appears in that 
control block’s mapping DSECT) and the contents of the field (listed sequen- 


tially). 


e After the formatted printout, a hexadecimal dump of the entire control 


block. 


Note: If the vTAmM formatted dump routine cannot access a field (either in the 
control block or in the chain of pointers to the control block), a note of the con- 
dition is made on the dump output. 


See VTAM Data Areas for a description of the fields in each formatted VTAM 
control block. See “vm GDUMP Dump” on page 286 for more information on 


this dump. 


PRDMP formats and prints SVC dumps and high-speed stand-alone dumps. (High- 
speed stand-alone dumps are not ordinarily formatted, but they can be formatted 
with this service aid.) Use PRDMP and supply the VTAMMAP control card in the SYSIN 
data. (The VTAMMAP options are shown below.) Use the SUMDUMP option on the 
PRDMP Command if you want to print the summary information contained in the 
dump. During PRDMP processing, VTAM formats and prints certain VTAM control 
blocks and the vTAM internal trace table. See the diagnostic manuals for your oper- 
ating system for more information on PRDMP. 
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You can choose one or more of the following options on the vTAMmaApP control card. 


The default is ALL. 
Option Specified 


ALL 


RDTFULL(nName) 


RDTHIER(Name) 


ROTSUM(name) 


ROUTES 


SES(name) 


STORAGE 


VTAM 


VTBASIC 
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PRDMP Action 


Formats the VTBASIC, RDTFULL, VTAM, STORAGE, ROUTES, and 
SES options. 


Formats all resource definition table entries (ROTES) and 
node control blocks (NCBs). If name is specified, formats 
only the RDTE specified by name. 


Formats the specified ROTE and al! ROTESs below it in the 
ROTE hierarchy. If name is omitted, formats all ROTEs. 


Formats the specified ROTE in short form (one line for each 
ADTE). If name is omitted, formats all ROTEs in short form. 


Formats explicit route table entries (ERTES), virtual route 
block (VRBLK). 


Formats the ROTE specified by name, and formats all sigs 
and ADTEs in session with name. The specified name can 
be any session endpoint, such as a logical unit, terminal, 
or application program. It also formats ACDEBS, APPCB8S, 
COPRS, FMCBS, FMCBEXTS, HSICBS, LUCBS, NSICBS, NSSCBS, 
RABS, SABS, SIBIXS, SIBRXS, and SIBXS. 


if name is not specified, it formats all Sigs and RDTEs, as 
well as ACDEBS, APPCBS, COPRS, FMC8S, FMCBEXTS, HSICBS, 
LUCBS, MPSTS, NSICBS, NSSCBS, PSTS, RABS, SABS, SIBIXS, 
SIBRXS, and SIBXs. 


Formats BPCBS, PXBS, SPANCS, PAGTBS, and PTES. 
Formats the following: 
¢ RDT and ROTES 


¢ Memory process scheduling table (mpsT) and process 
scheduling table (Pst). 


¢ ACDEBS, APPCBS, COPRS, FMCBS, FMCBEXTS, HSICBS, LUCBS, 
NSICBS, NSSCBS, RABS, and SABS. 


® NCBS (LONCB, ICNCB and XCNCB). 


¢ Buffer pool control blocks (BPCBsS), extension blocks 
(PXBS), Storage pool anchor block (SPANC), storage pool 
page table (PAGTS), and storage pool page table entries 
(PTES). 


¢ Locked queue anchor block (LQAB). 


e Waiting request elements (WRES) and event identifiers 
(EIDS). 


¢ Modules from the atcvT, in the form modname address 
modname address, sorted by module name. 


Formats the atcvt, the configuration table (CONFT), the VTAM 
internal trace (viT), and the component recovery areas 
(CRAS). 
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For example, to format the VIT, ATCVT, CONFT, CRA, ROT, and RDTES, specify the VTBASIC 
and RDTFULL options, like this: 


VTAMMAP VTIBASIC,ROTFULL 


PRTDUMP formats the same control blocks as those listed in “VMPRTDUMP Service 
Aid” on page 280. 


See “MVS Stand-Alone Dump” on page 284 and “MvSSVC Dump" on page 284 for 
more information on these dumps. 


mMvS SADMP Service Aid 
SADMP formats and prints low-speed stand-alone dumps. During SADMP processing, 
VTAM formats selected control blocks and prints them as part of the dump created 
by SADMP. 


See the diagnostic manuals for your operating system for more information on 
SADMP. See “MVS Stand-Alone Dump” on page 284 for more information on this 
dump. 


vM SDUMP Service Aid 
You can format VTAM control blocks for SOUMP output. The procedure is the same 
as that given in “VMPRTDUMP Service Aid” on page 280. 


With spumP, the same VTAM control blocks as those listed in “MVS ABDUMP Service 
Aid" on page 279 may be formatted, depending on which virtual machine was 


dumped. 


See “VMSDUMP Dump” on page 286 for more information on this dump. 
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several kinds of dumps can be produced in an Mvs system, depending on the type 
of failure and operator action: 


e “MVS Abend Dump” 

¢ “mvs SNAP Dump" 

e “mvs Stand-Alone Dump” 
e “mvs SVC Dump.” 


“MVS VM Formatting and Printing Dump Output” on page 279 tells you how to 
format and print the output. 


lf the appropriate DD card exists, an abend dump is produced when: 


e The operator enters a CANCEL command 
e An abend macroinstruction is issued 
¢ A job abnormally ends. 


To get an abend dump, the input stream for VTAM must contain a 0D statement with 
ddname SYSABEND. The resulting dump is written to the data set specified on the 
SYSUDUMP Or SYSABEND DD card. The contents of the dump depend on user specifica- 
tions. For more information, see the Supervisor manual for your operating system. 


To get a SNAP dump, iSSUe a SNAP macroinstruction. The resulting dump is written 
to the data set specified on the 0C8 operand of the SNAP macroinstruction. The 
dump data set must be opened before SNAP is issued. A separate DD statement is 
required for each job step in which SNAP is issued. The ddname can be any unique 
name except SYSABEND, SYSUDUMP, Or SYSMDUMP. The contents of the SNAP dump 
vary depending on the options you specify in the SNAP macroinstruction. The 
SDATA=ALL Or SDATA=CB options include major operating-system and selected VTAM 
control blocks in the dump. For more information, see the Supervisor Services and 
Macros manual for your operating system. 


Mvs Stand-Alone Dump 


mvs SVC Dump 
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The stand-alone dump is produced when the operator invokes the stand-alone 
dump program. This program can be invoked when the operating system is ina 
disabled wait state or looping. The stand-alone dump may be a high-speed dump, 
which is not formatted, or a low-speed dump, which is formatted. The dump output 
is written to the tape or printer (low-speed only) specified on the output operands. 
The output for a high-speed dump can be formatted by PRomP. For more informa- 
tion on the stand-alone dump, see MVS Service Aids. 


Svc dumps are produced under these conditions: 


¢ VTAM produces an SvC dump automatically when a program exception occurs. 
VTAM may or may not be terminated as part of this process. The system log 
indicates the location of the dump output and whether the dump was Suc- 
cessful. 


e An operator may request a dump with the operating system DUMP Command. 
This will not cause VTAM to terminate. 
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e An operator uses a SLIP command with ACTION=SvCD specified, and an event 
occurs that matches the trap indicated in the SLIP. 


¢ A macroinstruction issues an abend, and there is a DD statement with 
ddname = SYSMDUMP. 


e An SOUMP macroinstruction is issued. 


e System recovery routines produce an svc dump if VTAM causes an error, such 
as a program exception or abend. 


An svc dump is written to a SYS1.0UMPnn data set (if allocated), the SYSMDUMP output . 
data set, or the data set specified on the DCB operand of the soUmMP macroin- 

struction. An svc dump may be printed with the PRomP system utility. For more 
information on svc dump, see the Supervisor manual for your operating system. 
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Several kinds of dumps can be produced in a vm system, depending on the type of 
failure and operator action: 


¢ “VMSDUMP Dump’ 

e “VMGDUMP Dump" 

¢ “VMDUMP Command.” 

e “VMVMDUMP Command.” 


For dumping cP storage, see the VM/SP Operator’s Guide. 


“MVS VM Formatting and Printing Dump Output” on page 279 tells you how to 
format and print the output. 


An SDUMP dump is produced automatically when a machine program check or GCS 
internal error occurs. The resulting dump can be formatted and printed with the 
PRTDUMP Command of IPCs. The VTAM control blocks shown in “ MVS ABDUMP 
Service Aid” on page 279 are formatted in an SDUMP. 


The GDUMP command can be entered by the vm system operator. The resulting 
dump can be formatted and printed with the PRTDUMP Command of IPcS. The VTAM 
control blocks shown in “VMPRTDUMP Service Aid” on page 280 are formatted in 
a GDUMP. 


Note: For a loop problem, do not use the GDUMP command. Instead, use the 
VMDUMP command. 


The DUMP command can be entered by the vm system operator. This command 
produces a formatted hardcopy dump. 


vei VMDUMP Command 
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The vMDUMP command can be entered by the vm system operator. The resulting 
dump can be formatted and printed with the PRTDUMP Command of IPCs. The VTAM 
control blocks shown in “VMPRTDUMP Service Aid” on page 280 are formatted in 
@ VMDUMP. 


cp should have control when you issue this command. That is, you should either 
press PA1 or enter #cP before issuing the VMDUMP Command. 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


vse Dumps 
Several kinds of dumps can be produced in a VSE environment, depending on the 
type of failure and operator action: 


e “VSE Program-Initiated Dump” 
¢ “VSE SDAID Dump Facility” 

e “VSE Stand-Alone Dump Utility” 
e “VSE DUMP Command.” 


Note: Dumps produced by canceling vTaAM are of limited diagnostic value. Use 
other dump facilities to document a problem before canceling VTAM. 


vse Program-Initiated Dump 
Customer programs can produce dumps by using system dump macroinstructions 
(PDUMP, JDUMP, DUMP). Other IBM licensed programs, such as CICS/VS, also have their 
own dumping facilities, which may be useful in isolating some VTAM problems. 


vse SDAID Dump Facility 
The dump facility of SDAID is useful when debugging requires a dump of one or 
more specific storage areas on the occurrence of a specific event. The output 
device can be a tape drive or a printer. SDAID output on tape can be printed with 
DOSVSDMP. For more information on VSE dumps, including DOSVSDMmP and SDAID, see 
VSE Service Aids. 


vsE Stand-Alone Dump Utility 
A stand-alone dump, created with the DoSvspDmP utility, is useful when the severity 
of a system malfunction (such as a hard wait state) prevents using other methods. 
The output of a stand-alone dump is printed by DOSVSDMP. 


vsE DUMP Command 


The DUMP Command causes VSE to produce a dump of the storage area specified in 
the command. The operator can direct the dump either to tape or to a SYSLST 
device. To retrieve the dump information, you can do either of the following: 


e Use DosvspMmpP to have the dump information printed on the printer assigned to 
SYSLST. 


e Load the dumps recorded on the tape into your system’s dump library and use 
Info/Analysis to retrieve the dump information. 


see VSE Service Aids for more information about retrieving dump information from 
tape. 
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Other Service Aids 


Alert Messages 


The ncp in a 3720, 3725, or 3745 communication controller sends alert messages to 
VTAM whenever a serious or permanent error occurs in the communication con- 
troller. The ncp sends hardware error records to the maintenance operator sub- 
system (Moss). If the MOSS determines that they are permanent errors, it sends 
them back to the NcP, which forwards them to all owning host processors. 


lf a communication network management (CNM) application program, such as the 
NetView program, is active and authorized to receive alert messages, VTAM for- 
wards the alert messages to that program. Otherwise, vTAM sends a message to 
the operator’s console. 


Recording NMVT Alerts in LOGREC or SYSREC (V3R2) 


A network management vector transport (NMVT) is a Systems Network Architecture 
(SNA) request unit (RU) that contains solicited or unsolicited data, such as line sta- 
tistics and generic alerts. MVS VMLOGREC and VSE SYSREC are host data sets that 
contain records of various types of system failures, both hardware and software. 


VTAM records all unsolicited NMVT alerts from 3745s, and a// NMvT alerts from LANS 
and 9370s, in either MVS VM LOGREC or VSE SYSREC. If you have the NetView 
program, VTAM also forwards the NmvT alerts to the NetView hardware monitor for 
recording. 


VTAM identifies and records an NMVT alert as follows: 


¢ Each NMvVT has an SNA network services (NS) header of X'41038D'. 

* Each NMVT that is an alert has a management services (MS) major vector of 
X'0000'. 

¢ To determine the type of device that sent the NMvT alert, VTAM checks the 
Product iD subvector (X'11') of the NMvT for the hardware machine type. Each 
type of device has its own unique machine type; for example, each NmvT alert 
that comes from a 3745 has a machine type of C'3745'. 

¢ VTAM records the NMVT alert in LOGREC or SYSREC as a miscellaneous data 
record (MDR;type = X'91') with a device type of NMVT (X'30'). 


You can format and print NMVT alerts from LOGREC or SYSREC using the Environ- 
mental Record Editing and Printing program (EREP). For information on how to use 
the EREP program, see the EREP book or the Service Aids book for your operating 
system. 


For more information on NMvTs, see the NetView Hardware Problem Determination 
Reference, SC30-3366. 


vm vse Alerts (V3R1.2 and Later) 
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VTAM V3R1.2 and later uses the alert function to notify an operator of an actual or 
impending loss of availability of a resource. vTAM builds a network management 
vector transport (NMVT) for the alert. The NMvT can be traced with the Piu option of 
the viT. The piu trace of the NMVT contains several extensions. Figure 61 on 

page 289 is an example PiU trace entry of an alert NMVT. 
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D7C9E440 43990000 00863DD8 40000000 BLU ue drruitene OF seca 
20000000 00000001 O0000001 1C000001 We aoa Sea ed Grae * 
D7C9E4F2 O0000001 O0860B00 0041038D POA aw erehe etre que x 
00001000 10007B00 O00A0401 80000000 Pg Koteaate Pep es antes . 
D7C9E4F2 QOIOOOCOA 01081057 O61A0COF BP LUC wceaweaews ws 
153C1000 2311040E O2F5F6OF6 F4F2F8FO Tgapaaile tis 5664280* 
D7COE4F2 FOFIF3F1 F10804FQ F3FOFIFO *PTU201311. .03010* 
FIOAO6C1 C3C661E5 £3C1D416 11011300 *1, ACF/VTAM..... * 
D7COE4F2 11F9F3F7 F5000000 QOOOOFOFO *PTU2.9375..... 00* 
FOFOFOF5 F60E5104 02000508 03400000 *00056.5c2a8%% * 
D7C9E4F2 00003105 52030404 00910001 MPIC 4 diene uae . 
OFOO8000 C100C100 O004A108 4003A105 eS ate eles dea oa 
Figure 61. VM VSE PIU Trace Entry Example 


The NMVT RU that is traced contains the alert (X'0000') management services major 
vector. The alert major vector and its subvectors are described in SNA Formats 
and in the NetView Hardware Problem Determination Reference. 


In the example, the alert major vector has three subvectors that contain informa- 
tion to be used with “vm VSE Alert Description Codes.” The subvectors are the 
Basic Alert subvector X'91' and two Detail Qualifier subvectors X'A1'. (There 
may be as many as three Detail Qualifier subvectors of the alert major vector ina 
single alert NMvT). The Basic Alert subvector has an alert description code of C1 
and the Detail Qualifier subvectors have values of 0840 and 05. 


vm vse Alert Description Codes 
The list that follows describes each alert by description code and provides the list 
of detail qualifier items that accompany the alert. 


Code Failure 
66 Open Failure: Token-Ring Lobe 


Description: The adapter detected a problem on its lobe during the wrap-test 
portion of the insertion process. The insertion process did not complete. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


67 Open Failure: Token-Ring Fault Domain 


Description: The adapter detected a beaconing condition on the ring during 
the insertion process. The insertion process did not complete. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 
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Open Failure: Token-Ring Duplicate Station Address 


Description: The adapter detected the presence of a station with its address 
on the ring during the insertion process. The insertion process did not com- 
plete. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Open Failure: Token-Ring Remove Command Received 


Description: The adapter received a Remove Ring Station mac frame during 
the insertion process. The insertion process did not complete. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Open Failure: Token-Ring Lobe 


Description: An error was detected during the insertion process that is not 
defined in the previous alerts. These conditions are not expected to occur, so 
they are included within one alert definition. The insertion process did not 
complete. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Adapter Error: Local Token-Ring Adapter 


Description: A hardware error in the reporting station’s adapter has 
occurred. The adapter is now inoperable. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Wire Fault: Token-Ring Lobe 


Description: The reporting station’s adapter detected a wire-fault condition 
on the ring. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 
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6D Auto Removal: Token-Ring Lobe 


Description: The reporting station’s adapter has left the ring as part of the 
beacon automatic-recovery process. That is, the reporting station’s adapter 
was a member of the beacon fault domain. The station removed itself from 
the token ring and ran a self test, which was unsuccessful. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


6E Remove Command Received: Network Operator 


Description: The reporting station’s adapter received a Remove Adapter 
command from a LAN manager and, as a result, left the ring. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


70 Token-Ring Inoperative: Token-Ring Fault Domain 
Description: The ring has been beaconing for more than 52 seconds. 
Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


72 Token-Ring Temporary Error: Token-Ring Fault Domain 


Description: The ring was in a beaconing state for less than 52 seconds and 
then recovered. The sender of this alert does not know whether a station 
removed itself from the token ring to bypass the fault, or whether the fault 
was temporary. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


83 Link Error: LAN LLC Communications/Remote Node 


Description: The remote link station does not respond. The response timer 
(t1) has expired, causing the remote station to be polled. The retry count (n2) 
for the number of polls has been exceeded. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 
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84 Link Error: LAN LLC Communications 


Description: The remote link station sent a Disconnect Mode (0m) to the local 
link station. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


87 Software Program Error: LAN LLC Communications 


Description: The remote link station sent an SABME (Set Asynchronous Bal- 
anced Mode-Extended) to the local link that had been previously initialized 
through an SABME-UA (Unnumbered Acknowledgement) exchange. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


AQ Software Program Error: LAN LLC Communications 


Description: The local link station sent an invalid or unsupported frame to 
the remote link station. That resulted in the remote link station returning a 
frame reject. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


A1 Software Program Error: LAN LLC Communications 


Description: The local link station sent an !-field when not permitted. That 
resulted in the remote link station returning a frame reject. 


Detail! data: 


1. Channel unit address 
2. Command 
3. Error code. 


A2 Software Program Error: LAN LLC Communications 


Description: The local link station sent an invalid send sequence number. 
That resulted in the remote link station returning a frame reject. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 
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A3 


AA 


AB 


AC 


AD 


Software Program Error: LAN LLC Communications 


Description: The focal link station sent an I-field that was too long. That 
resulted in the remote link station returning a frame reject. 


Detai! data: 


1. Channel unit address 
2. Command 
3. Error code. 


Software Program Error: LAN LLC Communications 


Description: The remote link station sent an invalid or unsupported frame to 
the local link station. That resulted in the local link station returning a frame 
reject. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Software Program Error: LAN LLC Communications 


Description: The remote link station sent an I-field when not permitted. That 
resulted in the local link station returning a frame reject. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Software Program Error: LAN LLC Communications 


Description: The remote link station sent an invalid receive sequence 
number. That resulted in the local link station returning a frame reject. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Software Program Error: LAN LLC Communications 


Description: The remote link station sent an I-field that was too long. That 
resulted in the local link station returning a frame reject. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 
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BE Configuration or Customization Error: Local System Operator 


Description: The local system operator has made an error in the VTAM defi- 
nition. One of the following situations has occurred: 


e A physical unit has dialed in, and there are no more available lines 
defined in the LAN major node. 


¢ The activation of a line in a LAN major node has caused the total number 
of active lines to exceed the maximum stations coded for the LAN major 
node. 

¢ A dial out has been attempted that will cause VTAM to exceed the 
maximum stations defined for the adapter. If more than one user is con- 
nected to the adapter, then the maximum number of stations must include 
the total number of stations for all connections. 


Detail data: 


1. Channel unit address 
2. Reason code: 


04 Dial in line not available 
08 Maximum number of stations exceeded (line activation) 
09 Maximum number of stations exceeded (dial out). 
BF Communications Subsystem Failure: Communications Subsystem Controller 
Interface 
Description: One of the channel programs for the CETI group failed. 
Detail data: 


1. Channel unit address 
2. Channel status 
3. Sense. 


CO Communications Subsystem Failure: Communications Subsystem Controller 
Interface 


Description: A command to the adapter has reported an unsuccessful com- 
pletion or an asynchronous indication has been received from the adapter. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


C1 Communications Subsystem Faijure: Communications Subsystem Controller 
Interface 


Description: Local area network support code detected an error. The error is 
not the result of a user definition. 


Detail data: 


1. Channel unit address 
2. Reason code: 


01 MAXDATA segmenting error 


02 Sequence error 
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C2 


C3 


C4 


C5 


03 Invalid Piu 
05 Adapter input is discarded 
06 ceETI architecture violation 


07 Unexpected SABME or xID received. 


Configuration or Customization Error: Local System Operator 


Description: The local system operator has made an error in the vTAm defi- 
nition. An invalid local or remote node address was specified. Either the sap 
address or the mac address is invalid or not recognized or the station is not 
on the ring. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Configuration or Customization Error: Local System Operator 


Description: The local system operator has made an error in the vtam defi- 
nition. The maximum data size is too large or invalid. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Configuration or Customization Error: Local System Operator 


Description: The local system operator has made an error in the vTAm defi- 
nition. The service access point (SAP) address on the PORT statement is 
already in use. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 


Configuration or Customization Error: Local System Operator 


Description: The local system operator has made an error in the vTtam defi- 
nition. An invalid number of stations was specified on the PoRT statement or 
the number of lines defined in the LAN major node is too large for the adapter. 


Detail data: 


1. Channel unit address 
2. Command 
3. Error code. 
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Warning: Single Station on the Ring 
Description: The adapter has opened and it is the only station on the ring. 
Detail! data: 


1. Channel unit address 
2. Command 
3. Error code. 


Configuration or Customization Error: Local System Operator 


Description: The local system operator has made an error in the VTAM defi- 
nition. The station that is being activated as a LAN resource is not defined to 
VTAM aS LAN-Capable. 


Detail data: 


1. Channel unit address. 
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vm vse Description of Detail Qualifier Items 


The following list describes the items in the detail qualifier data fields of an NMVT. 


Channel unit address 


Command 


Error code 


Channel status 


Sense 


Reason code 


This is the channel unit address specified on the PORT 
statement that defines a CETI group. 


This is the command that was processed when the alert 
was reported. Commands are used by VTAM LAN Support 
to communicate with the adapter. See “vm vse 
Command Values Reported in Trace Entries” for more 
about commands used by LAN support. 


This is the completion status code that is associated 
with the command. 


This is the channel status that is reported for a failing 
CET! channel program. 


This is the sense that is reported for a failing CET! 
channel program. This value may be 0 if no sense data 
is available. 


This is the reason code for the failure reported by the 
alerts with description codes of BE and C1. See the 
listing of those description codes for explanations of the 
values reported. 


vm vse Command Values Reported in Trace Entries 
Figure 62 on page 298 describes the command values reported in trace entries. 
These are the commands used by vTAMLAN support and the Token-Ring Subsystem 


when they communicate. 
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Command 
Value Description 


810000 Set network parameters 


040C0D 
04CCOD 


040COE Deactivate vTAM’s service access point 
04CCOE 


040C0A Cause the subsystem to send test frames for remote station 
04CCOA address resolution and to establish a logical connection with a 
remote station 


040C0B Cause the subsystem to break a logical connection with a 
04CCOB remote station 


040020 Perform SNA exchange identification (xID) 
04CC20 
044C20 
048020 


040D00 
04CD00 
044D00 
048D00 


040D01 
04CD01 
044D01 


040D10 
04CD10 
044D10 


040D50 
04CD50 
044D50 


040660 Send and receive test frames to perform VTAM link level 2 (LL2) 
04C660 test 


044D1A Pass asynchronous status and statistics 
024D1A Pass asynchronous status and statistics 


Figure 62. Command Value Descriptions 


Activate VTAM’s service access point 


Perform SABME - UA exchange 


Perform DISC - UA/OM exchange 


Send and receive normal data 


Control the flow of data to and from a remote station 


The commands in the table are in the form: 


XXYXXX 


where 


Xx_xXxx is the command identifier and 
y is the command type. 
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The command types for y and the direction of flow are: 


Confirmation of a request From the subsystem to VTAM LAN Support 


Response to an indication 


0 
4 
8 
C 


Note: The set network parameters command flows as both a request and a confir- 
mation. It is always shown as 810000 in the vTAM trace command fields. 


mvs Messages Issued for 3745 Bus Switching (V3R2) 
A 3745 can be configured with one or two ccus. For twin-ccu 3745s, NCP V5R1 Sup- 
ports the two CCUs as independent communication controllers. 


A twin-ccu 3745 can be operated such that, if one of the ccus fails, the maintenance 
and operator subsystem (MOSS) switches the IOC buses from the failing Ccu to the 
active ccU. The operator can then activate all or part of the resources of the failing 
ccu to the other ccu. 


The bus-switch can also be performed at the operator’s request. 


If the bus-switch occurs in the middle of a vTAM channel operation, such as a Read 
or a Write, VTAM issues messages |ST881I and IST882I. 


MVS Message IST881I: Message |ST881! tells the operator that VTAM either was 
unable to contact a link station, or lost contact to a link station. 


This message is issued for one of the following reasons: 


¢ A bus is being switched from one ccu to the other. 
e A dump or load is being done on another channel. 
e A dump or load is being done by a local disk. 


When the link station becomes available (as indicated in other messages), VTAM 
resumes CONTACT processing. 


To terminate CONTACT processing before the link station becomes available, issue a 
VARY INACT,F Command to deactivate the link station. 


MVS Message IST882I: Message isTs82i tells the operator that VTAM is waiting fora 
device end from the link station identified in message IST8811. 


You should check to see if the link station is online. If it is, then there is a possi- 
bility that NCP is being dumped or loaded over another channel adapter, and no 
further action is necessary. 


Note: If the link station is not operating, not physically connected, or not online, 
VTAM never receives the device end. In those cases, you should issue a VARY 
INACT,F Command to deactivate the link station. 
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Hardware Error Recording 


During error recovery processing (ERP), VTAM writes outboard recorder (OBR) 
records and miscellaneous data records (MDRS) to LOGREC or SYSREC. OBR records 
are written for hardware errors on channel-attached devices. (VSE VM OBR records 
are written for icA-attached devices as well.) MDRS are written for hardware errors 
on NCP-attached devices. 


VTAM collects the error data and puts it in LOGREC or SYSREC. EREP formats and 
prints the LOGREC or SYSREC data set. 


OBR records contain information about the following: 


¢ Statistics on the overflow of error counters for devices 

e Sense and status data on all channel-attached devices 

e Failures on teleprocessing devices 

¢ Temporary or intermittent failures on i/o devices 

e End-of-day requests 

¢ Permanent channel and device errors (unrecoverable errors and unit checks). 


Permanent error records show the date, time, logical unit name, type of record, 
contents of counters, failing Cccw, channel device name, csw, sense information, 
device type, and flags. The time field shows the time at which the permanent error 
occurred. 


Counter overflow and end-of-day records show the date, time, logical unit name, 
type of record (counter overflow or end-of-day), contents of counters, channel or 
unit address, and device type. The time field shows the time at which the counter 
overflow or end-of-day error occurred. 


Counter overflow records are written when the sio counter, the temporary error 
counter, or a device statistics table counter is about to overflow. (VTAM maintains 
two counters for each channel-attached device. One counter keeps track of the 
number of Sio commands issued to the device; the other counter keeps track of 
temporary errors. Counters of unit check errors by error type are also maintained 
in the device statistics table.) 


End-of-day records are written whenever a VARY INACT command is entered for a 
link or channel. 


Miscellaneous data records contain the following information: 


e Statistics on the overflow of error counters for communication controllers 
¢ Record Maintenance Statistics (RECMS) RUS 
e Permanent errors on NCP-attached devices. 


See the EREP manual for information on printing and interpreting these records. 


Logical Unit Connection Test (IBMTEST) 


300 =VTAM Diagnosis 


You can enter the IBMTEST command from a terminal to find out whether that ter- 
minal can communicate with its owning sscp. When you use the IBMTEST command, 
an unformatted Ru is sent through the network path supporting the LU-SSCP session. 
This RU contains the iBMTEST Command followed by the number of times the SSCP is 
to return (echo) the data to the logical unit and optional data (up to 247 bytes) being 
sent to the SSCP. 
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You can increase the possibility of repeating an intermittent error that is hard to 
re-create by using IBMTEST, since you can request up to 255 echoes. You can also 
use it to determine whether a suspended LU-LU session is caused by either a hard- 
ware problem or by a problem with vTAm or an application program. 


Start this test with the following command: 


IBMTEST [n][,data] 


n 
specifies the number of times the test data should be returned to the terminal. 
Specify n as a decimal number in the range 1 through 255. If no value is speci- 
fied, a value of 10 is used by default. 

data 


specifies the test data to be returned. Specify a character string of up to 247 
characters, or the maximum message length of the terminal, whichever is 
smaller. If no test data is supplied, VTAM returns the alphanumeric sequence: 


‘ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789' 


The iBMTEST Command is valid only for terminals that use the USS LOGON format. 
The IBMTEST command must be defined in the uss table for that terminal. The 
SSCPFM option for that terminal must specify something that is supported and starts 
with uss. 


Note: This echo check does not verify that a terminal can establish a session with 
an application program in the host, because the session request may specify a dif- 
ferent network path than the one supporting the terminal’s Lu-sscp session. If the 
requested path is unavailable, the session request is rejected, even though another 
path is available. 


If there are any errors, the VTAM operator receives a message that contains the 
logical unit name associated with the terminal, the number of echoes that took 
place before the 1/O error, and the error sense code. 


NCP Error Recording 
NCP error recording procedures create Record Maintenance Statistics (RECMS) RUS 
that contain: 


¢ The initial error status that began the recovery process 


e The final error status that caused the permanent RECMS RU to be generated. 


RECMS RUS are created for each adapter check, program check, unresolved inter- 
ruption, counter overflow, 1/0 operation, and permanent line error. The RECMS Rus, 
which contain the miscellaneous data record (MOR), are sent to the vTAM host that 
owns the failing component. VTAM then records the MDR and writes the error infor- 
mation to the LOGREC or SYSREC file. 


Patch Areas 
Patch areas are available for VTAM, TSO/VTAM, and VSCS. 
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VTAM Patch Area 


VTAM supplies a fixed patch area as a separate module. You can insert short 
service programs in this area to do maintenance-related functions. ISTPATCH iS 
loaded into LPALIB during VTAM initialization and is pointed to by the ATCPTCHA field 
inthe ATcvT. The initial size of the patch area is 64 bytes, but you can change the 
size by link-editing a module named ISTPATCH of the desired size. 


Code the necessary change in the patch area. (ISTPATCH follows the same coding 
rules as other modules in LPALIB.) Then replace part of the failing code witha 
branch to the patch area, allowing you to bypass the failing code. 


“VS TSO/VTAM Patch Area 


TSO/VTAM maintains a patch area in each module. The size of the patch area varies 
from module to module. If you need more information on using these patch areas, 
contact the 18m Support Center. 


vm VSCS Patch Area 
VSCS Supplies a fixed patch area as a Separate module. You can insert short 
service programs in this area to do maintenance-related functions. DTIPATCH is 
addressable from all vScs code modules and is pointed to in the vscs internal trace 
table header. 


Using a Dump to Follow the Execution Sequence of VTAM Components 
VTAM traces the flow of the execution of three vrAM components, SSCP, PUS, and LUS, 
by saving the work areas of modules in these components. The addresses of the 
module work areas are stored in either of these control blocks: 


e Network configuration services parameter list (NCSPL) 
e Request/response unit processing element (RUPE). 


In the RUPE, the work area address can be found at RUPEDAP. In the NCSPL, the work 
area address can be found at NCSPLWKA. For the hex offsets of these fields, see 
VTAM Data Areas. 


The NCSPL or RUPE work area contains the work and save areas for each module 
invoked for the command that the NCSPL or RUPE represents. The module work and 
save areas provide status information that pertains to both the processing of that 
command and any interruptions in the processing. 


This status information includes a record of which modules were entered, which 
modules returned to their callers, and which modules returned with a return code. 
Each module save area contains the 4th, 5th, 7th, and 8th characters of the module 
name and the register 15 value that includes a pointer to the last module called by 
this module. 


The high-order byte of the register 15 save area also indicetes the status of the last 
module called, as shown below. (MVS/XA |n 31-bit mode, the address fills register 
15, so that the status then overlays the high-order byte of the address in the reg- 
ister 15 save area.) 
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Byte 

Value Status Indicated 

FE The cajled module has returned to this module without a return code. 
FF The called module has not returned to this module. 


nn The called module has returned to this module with a return code of nn. 


Figure 63 on page 304 is an example of what the NCSPL or RUPE work area might 
contain for modules invoked for a vTAM process. 


~... VTAM Error Recording for Communication Adapter Lines 
VTAM error recording procedures create Record Maintenance Statistics (RECMS) RUS 
to record information about the following conditions: 


¢ Recovered (temporary) SDLC link and station errors 

e Recovered (temporary) BSC link and station errors 

e Unrecoverable (permanent) SDLC link and station errors 
e Unrecoverable (permanent) Bsc link and station errors 
¢ Bsc 3270 sense/status data. 


RECMS RUS are sent to a communication network management (CNM) application 
program, if one is designated to receive these Rus. 


“Si YTAM also writes the RECMS records On SYSREC. 


Formats of the RECMS RUS created by VTAM are mapped by the ISTRMD control block; 
ISTRMD is described in VTAM Data Areas. 


Use eReP to edit and print the error data. (See the EREP manual.) 
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NCSPL/Rupe work area 


Next available work area 


Fe | : Module called 


ACSD 


- Previous save area = 


4 Next save area = ©) 


Register 14 
04 | ‘ Module called 


* Previous save area = © 
Next save area 


Register 14 
: Register 15 


ISTACCSD 


SS 


} ISTACCRT work area 


ISTACCOE 


———+_| 


} ISTACCSD work area 


ISTINCF1 


a a 


} ISTACCQE work area 


} ISTINCF1 work area 


Figure 63. Save Area Conventions 


304 VTAM Diagnosis 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


ISTACCRT X ISTACCSD 
(ISTACCSD still 
processing; 

has not returned) 


ISTACCSDX ISTACCOQE 
ISTACCSD X ISTACCQE 
(No return code) 


tSTACCOE X ISTINCF1 
ISTACCSDX% ISTINCF1 
(Return code = 4) 
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Chapter 8. Using the VTAM Internal Trace 


Most VTAM traces show information flow between vTAM and other network compo- 
nents. However, the vTAm internal trace (VIT) provides a record of the sequence of 
events wifhin VTAM. These internal events include the scheduling of processes (for 
example, POST. WAIT, and DISPATCH), the management of storage (for example, 
VTALLOC), and the flow of internal Pius between vTAM Components. | 


Note: vTAm disables the viT when it issues SDUMP to prevent the viT table from being 
overwritten. 


Together with the operator console listing and a dump, output from the viT can help 
you reconstruct sequences of VTAM events and find internal vTAM problems more 
easily. 


Activating the Internal Trace 


Use one of the following methods to start the vit: 


¢ You can use the TRACE Start option, with TYPE=VTAM specified, to start the vIT 
when you first start VTAM. See VTAM Installation and Resource Definition for 
more information on how to use the TRACE start option. 


e You can use the MODIFY TRACE command, with TYPE =VTAM specified, to start the 
viT after you have started vVTAM. See VTAM Operation for more information on 
how to use the MODIFY TRACE command. 


Selecting Internal Trace Options 
Both the TRACE start option and the MODIFY TRACE command have an OPTION operand 
you can use to select viT options. You select one or more of these options to indi- 
cate the VTAM functions to be traced: 


¢ The APi option, for application program interfaces. 


This option helps you determine whether an application program is causing a 
problem. API entries are written for RPL macros, RPL exit routines, user exit rou- 
tines, and user posts. 


¢ The APPC option, for LU6.2 application program interfaces. 


This option helps you determine whether an LU 6.2 application is causing a 
problem. LU 6.2 entries are written for APPCCMD macro invocations, user posts 
and exit scheduling by LU6.2 code, and message unit transmissions between LU 
6.2 components. 


¢ The clo option, for channel input and output. 


This option helps you isolate problems related to channel i/o. cio entries are 
written for attentions, error recovery, interruptions, HALT I/O SVC, and START 1/O 
SVC, 


¢ The ESC option, for execution sequence control. 


This option helps you track in detail the flow of requests for a given process. 
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¢ The Lock option, for locking and unlocking. 
This option helps you determine when vTAm modules get and release locks. 
* The MSG option, for messages. 


This option helps you correlate other vit entries with the console messages 
even if the console sheet is lost. msG entries are written for all messages to the 
VTAM operator. 


¢ The NAM option, for network resource management. 


This option helps you follow the services of the Network Resource Manage- 
ment component. These include the assignment of, references to, and the 
deletion of certain vTAM resources such as node names, network addresses, 
and control blocks. NRM entries are written for SAT macros issued by VTAM 
modules. 


¢ The Plu option, for path information unit flows. 


This option, like the vo and buffer contents traces, helps you isolate problems 
to hardware, to the NCP, or to VTAM. Plu entries are written for all 1/0 to and from 
VTAM, which can be an advantage over i/o and buffer contents traces. 


e The PSs option, for process scheduling services. 


This option helps you track the flow of requests through vTAM. Pss entries are 
written for the VTAM macros that invoke and contro! pss, scheduling and dis- 
patching VTAM routines. 


¢ The sms option, for storage management services. 


This option helps you isolate problems caused by storage shortages. When 
used with the sscp or pss trace options, it can also help you isolate internal 
VTAM problems. SMS entries are written when SMS macros are used to request 
or free fixed- or variable-length buffers. 


e The sscp option, for system services control point request scheduling and 
response posting. 


This option helps you isolate a vTaAm problem to a specific VTAM component or 
module. sscp entries are written for the request/response units (RUS) sent 
between vTAM components. 


The vit always traces the following exception conditions, regardless of the options 
you specify: 


‘Option Exception conditions traced 


API option RE, UE, or UP entries with a non-zero RPL return code or 
feedback 


ACA and ACI entries when issuing the following commands: 


e SEND ERROR 
e DEALLOC ABND 
e REJECT 


APPC option 


Other entries with non-zero return codes (except RPLGRCSC) 
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Option Exception conditions traced 


PIU option Entries for a response with a non-zero sense code 


All NRSP and DSCD entries 


SMS option Entries with non-zero return codes 


SSCP option Entries with non-zero return or sense codes 


All CPRC entries 


(No option) All SNAP entries. 


Note: Even if you do not specify any options, the vit still traces the above exception 
conditions, if it is active. | 
Figure 64 is a summarization of the viT options and the records they create. 


Note: The ABND and LOST trace records are not created by specific vit options. 
They are created as a result of exception conditions. 


Figure 64. VIT Options and the Records They Create 


Selecting Internal or External Trace Recording 
The vit can record the trace data either internally in a trace table or externally ina 
trace file. You specify which using the MODE operand of the TRACE start option or 
the MODIFY TRACE command. 


Recording Trace in Internal Table (MODE = INT) 
If you set MODE =INT On the MODIFY TRACE commana, or if you let MODE default to INT, 
the vit writes the trace records in an internal trace table. The table is allocated 
and initialized in a storage area. 


* mvs The storage area is in common service area (CSA). 
* vm The storage area is in common storage. 


* voe The storage area is in the vTAM VFBUF buffer pool, located in the VTAM parti- 
tion. 


LY30-5601-1 © Copyright IBM Corp. 1984, 1969 Chapter 8. Using the VTAM Internal Trace 309 


VOLAAEB20 
VOLAAEB40 
VOLAAEB60 
VOLAAEB8O 
YOLAAEBAO 
VO1LAAEBCO 
VOLAAEBEO 
VO1AAECOO 
VO1AAEC20 
V@1AAEC49 
VO1AAEC60 
VO1AAEC8O 
VOLAAECAO 
VO1AAECCO 
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Examine the internal trace table by taking a dump of vTAM with the appropriate 
storage area. 


Note: The internal trace records contain exactly the same information as an 
external file (MODE = EXT). 


Find the internal trace table in the dump by first locating the ATcvT. Field ATCITTBL 
contains a pointer to the trace table. The internal trace table contains a 32-byte 
header followed by 32-byte trace records. 


The siZE operand of the MODIFY TRACE command specifies the number of pages (1 to 
999) in storage to be allocated for the table. Because it is a wraparound table, 
specify enough pages to ensure that the vit will not overwrite important trace 
records when the table fills and begins to wrap around. 


The SIZE operand should also reflect the amount of storage available for the 
internal trace table. !f there is not enough storage available for the number of 
pages specified, you will receive a message indicating that internal trace activation 
failed. 


You can change the size of the internal trace table while the viT is running by 
issuing a MODIFY TRACE Or MODIFY NOTRACE command with a new SIZE operand. 


Note: Issuing another moDIFY command while the vit is running frees the current 
internal trace table and begins a new one. The trace information that the vit has 
already written in the current table is lost. 


Figure 65 shows an example of internal trace records written with MODE=INT and 
printed in dump output. 


C4C9E2D7 0A990048 O1AC8EEO 00B69720 
C4C9EZF2 O1AF7120 30000000 GaooCcaO 
D3D2C5E7 OAQOO1CO 80869738 HO000E00 
E4D5D3D2 OACOG100 88869738 GOG00000 
C5E2C340 GAG00048 81B2F228 90869720 
E2D9E3C6 GACOOOOR OOO0C000 60010001 
C7C203D2 GAGOOCEO 01C27E68 G1ACBC9IO 
E5E3C1D3 OAGCO00ON 01813008 OGOGOOFA 
C3C30600 OA540000 O1AE179C C9D5C907 
C3C3F254 OECOCOON eeGeeeeO OeEcOoCe 
D8E4C540 OA540080 OLAC8EEO 00BE9758 
D8E4C5F2 B19F118C 30480000 eoQ0d00N 
D3D2C5E7 OAGCO160 00869776 eO000C0D 
E4D5D3D2 OAQGO100 06869770 60000100 


80008000 80000000 E3E2D5C9 O1AE1560 SDISP so252 sai sane see sete TSNI...-* 
GO0G0000 GOCOOCEO COOCOOO O1AF7120 Cy errr er ee eee ~ 
BIJE58FA OOGONGCO COODEOCO O1AE1560 *LREX cst eeveaaseunieee eee uses -* 
Bi9E59C8 GeCOOEeE 01800000 O1AE1560 MUNUK soc: orcstateaneies Hwee eeeews 2 
81A16222 O1AF7120 C9D5C9D7 01AE1560 MESO scones PT Ce INIP...-* 
BIB2F33E O1C25FDO 40404040 40494040 *SRIF aac cewar Sues 3..B- m 
819F0304 00000088 81830206 9G00000 *GBLK..... Bas jue vadese ede vaawees .. 
819F0528 GO00CG05 81830300 OCOsC00e PNTAL Sis ei ee sees tae ee eee ews = 
8182F716 00000801 00010000 0001003E gl 2 6 re INTP is Paeie ioe ene. . 
ecceoeed EooOse0O OeEGOaGO CCEBN0000 POC2 isi este wens nereruawinweses' fea ~ 
Q1C27E68 OGO8COGO D3E4D9E3 EODCRO0N QUE: ary ctw escetere evs B=..... LURT....* 
goeaeoNs EHOEGG0O OROOOECE ON0CR000 NQUE? i sisite sink joes eis Saw ee soto ig 
SIDEAZ4C CROOCOGO OCOCOOCO O1AE1560 MERE Rivtiawee evewties eer -* 
B19EA3A4 GOOOOGCO 01800000 O1AE1560 oS eer eee ee ee -* 


Figure 65. Internal Trace Records in Dump Output (MODE = INT) 


The first line of the internal trace table is the header, which contains the following 
status information: 


Byte (hex) Contents 


00-07 Current entry time stamp (the time the current record was entered) 
08 — OF Present wraparound time stamp 

10-17 Last wraparound time stamp 

18—1B Address of the most recent entry in the table 

1C—1F Address of the last entry in the table. 
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Recording Trace in External File (MODE = EXT) 


If you set MODE = EXT on the MODIFY TRACE command, the vit writes the trace records 
in an external trace file, rather than an internal trace table. You should use this 
option when you must collect large amounts of trace data, to lessen the chance of 
wraparound and lost data. 


Note: The trace data can still fill the external trace file, wrap around, and begin 
overwriting itself if you do not ensure that the external trace file is large enough. 


The external trace file contains the same information as the internal trace table. 
However, unlike the internal trace table, the external trace file does not contain a 
first-line header record. 


The external trace file is produced by GTF, and the default file name is 
SYS1.TRACE. You can print the internal trace data with GTF, PRDMP or TAP. Use the 
EDIT option of PROMP and set the USR=(FE1) Keyword. For more information on GTF 
and PRDMP, see “Activating VIAM Traces” on page 222 and “ Using PRDMP” 
on page 224. For more information on TaP, see the NCP, SSP, and EP Diagnosis 
Guide. Figure 66 is an example of internal trace output printed with PRDOMP. 


USRFD FEL ASCB OOFAZ2080 JOBN HSTCO16 
All ASTD 11 TYPE 15 EXTDS 40 OPT! 20 RPL 00164DD4 ARG Q0000000 RH3 00 
SRTYP 09 VTFL 200010 CNTRL 800000 OPTC 10309450 80002010 
Al2 RTRN ©0000000 LOGMD PLUNM SLUNM 
USRFD FE1 ASCB OOF A2080 JOBN HSTCO16 
CCO AS!D 11 TYPE QO CBID 54 SAVE OQL1DC7CF8 SVID ISSR 81AE4474 
ORIG OOD0G0000A000C DEST Q000000A000C 
CC2 CBID 54 RU 00000000 63000024 010B3450 O1DABO18 00000000 GOOODQ00 SENSE Q0000000 
USRFD FE1 ASCB OOF97080 JOBN HSVTAM 
SRTF ASID RC 00 PARM QO0000000000A0CCC ISSR 81E4403E SRTE O1F35E80 NETID 
USRFD FE1 ASCB 00F97080 JOBN HSVTAM 
CCI ASID 66 TYPE 00 CBID 54 SAVE O1F5C950 SVID- INSI ISSR 81E3A20C 
ORIG ONDGOIOADOOC DEST QOO00000A000C 
CC2 CBID 54 RU O0C81QA01 63000024 01DB3450 O1DABO18 90000000 OADOOCOO SENSE 90000000 
USRFD FEL ASCB OOFA2080 JOBN HSTCO16 
UP ASID 11 TYPE 15 EXTOS 40 CODES 0G@0000 RPL 00164004 ECB 00000000 AREA 90000000 
RLEN 90000000 CID 00000000 FBK2 90000000 
USRFO FEL ASCB OOF97080 JOBN HSVTAM 
CCI ASID 66 TYPE OO CBID 58 FLAGS 80 RC 00 SAVE 010C7C58 SVID 
ISSR 81E1@890 CPCB 00009000 58488000 00000000 
SVC 020 ASCB OOFA2080 CPU 0000 JOBN HSTCO16 OLD PSW 075C0014 OO961F5E TCB OO5FFIF8 MOON SVC-T2 
R15 00000000 RO GOOO0000 R1 005A0270 
PLIS? 805A03C8 
USRFD FE1 ASCB OOF97080 JOBN HSVTAM 
CCI ASID 66 TYPE 00 CBID 58 FLAGS 80 RC 00 SAVE 010C7C58 SVID 
ISSR 81£10890 CPCB Q0000000 58488000 00000000 
Figure 66. .. Internal Trace Records in GTF Output (MODE = EXT) 
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The trace file is produced by cpTRaP. You can format the file with TRAPRED. For 
a full explanation of printing trace records, see “ Using CPTRAP and TRAPRED” 
on page 225. Figure 67 on page 312 is a sample of the output. 
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3D OE VTAM 


TIME OF DAY CLOCK 
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VM/ST USER REQUESTED GTRACE 
Q7FOF2B3CB2BAA40 


LENGTH OF GTF HEADER AND TRACE DATA = 0030 
FORMAT ROUTINE ID = FD 


EVENT IDENTIFICATION 
AREA 00105308 SP# OOQOO0E5 LENGTH 00099368 RC 
VM/ST USER REQUESTED GTRACE 


VFR SSR QAD1D4 
3D O£ VTAM 


= EFEL 
00000000 INIT 00000000 00000000 


TIME OF DAY CLOCK = 97F6F2B3CEA29E00 
LENGTH CF GTF HEADER AND TRACE DATA = 0030 
FORMAT ROUTINE ID = FO 
EVENT IDENTIFICATION = EFE] 
CCI FLGS 00 ISSR O902EA CBID 54 SAV 106938 SVID INS] CID 10011091 RU 00000000 00006000 000000C0 


3D OF YTAM 


Vi4/ST USER REQUESTED GTRACE 


TIME OF DAY CLOCK = 97F6F2B301131C80 
LENGTH OF GTF HEADER AND TRACE DATA = 0030 
FORMAT ROUTINE ID = FD 

EVENT IDENTIFICATION = EFEL 


QUE ISSR A1289E 


RPH 20000090 
VM/SIT USER REQUESTED GTRACE 
97F6F 2B3D3807860 


3D OE VTAM 


TIME OF DAY CLOCK 


PST 5485C008 PAB 108436D8 WG 00 ELM 104F40 PABCHN 00000000 NAME NORT 


LENGTH OF GTF HEADER AND TRACE DATA = 0630 
FORMAT ROUTINE ID = FD 
EVENT IDENTIFICATION = EFE] 


FBLK ISSR ALOEEA 


90000000 
VM/ST USER REQUESTED GTRACE 


30 OE VTAM 


AREA 00104E20 ANCH 00849928 LENGTH Q0000060 RC 


00000000 INIT S500AA664 


TIME OF DAY CLOCK = 97F6F2B3D5E01C80 
LENGTH OF GTF HEADER AND TRACE DATA = 0030 
FORMAT ROUTINE ID = FO 

EVENT IDENTIFICATION = EFE] 


Figure 67. yxy Internal Trace Records in CPTRAP Output (MODE = EXT) 


VTAM INTERNAL TRACE 


VTAL E5E3C1D3 34000000 
QUE D8E4C540 340E0010 
QUE2 D8E4C5F2 6087DC70 
VTAL £E5E3C1D3 34000000 
QUE D8E4C540 34490010 
QUE2 DB8E4C5F2 6071886E 
YTFR £E5E3C6D09 34000000 
ADSP C1C4E2D7 =32000000 
DISP C4C9EZD? 320E0010 
DIS2 CAaC9E2F2 Q09CDO10 
EXIT C5E7C9E3 32000010 
AXIT CIE7C9E3 32000000 


vse The external trace file is produced by TPRINT, and the default file name is 
VTAM.TRACE.FILE. Use TPRINT Or TAP to print the internal trace data. See ‘yoe Using 
TPRINT” on page 227 for more information on using TPRINT. For more information 
on TAP, see the NCP, SSP, and EP Diagnosis Guide. Figure 68 is an example of 
internal trace output printed with TPRINT. 


85.295/18:35:54.01  LRC(62) 

0088C058 FFFFES5D7 60718532 00000078 00000000 0000000 VTAL..... HaweeVl Seesyaeage ane ees 
3297F010 OO0980BEO OO9CD01O0 O0000000 DICIE3E6 OO000001 QUE ..... 10 are Care re ee RATWS ss 
04400000 000000080 00000900 Q0000000 00000000 O0000000 QUE2-G... ....... ee eee eee. 
0O88C660 FFFFE5D7 60718580 90000140 OG000000 O0000000 VTAL..... a ener A cacard ree ae eee 
2497F9A8 O0072BF18 O088C660 00000000 C3C6C6C5 ONCOD000O QUE ..... POY sae HE uae CPP Es eins 
04400000 00000000 00000000 O0000000 Q0000000 OOOQD00D QUEZ-.H>. ...... eee eee eee eee 
0088C058 FFFFE5D7 60718ABO 00000078 00000000 QO0000000 VTFR..... Hast.2 MPS waoeaarae Ru Sisluag 


0097FO010 Q0000000 oa0000000 90000000 80000000 O0980BEO ADSP..... PUG hear ee Stanmean es Ou 
0097F010 QO980BEO 809CD010 80000000 DICIE3E6 O0A31360 ODISP..... PUR cQGe eecte as RATW.T.- 
04000000 00000000 00000000 00000000 00000000 O0N000000 DIS2....... Lee ee ee eee eee 
3297F010 OO980BEQ 50A439AC 80000000 O0A43C00 O00A31360 EXIT..... POG oe BU si caed USauTas 


3297F010 00000000 00000000 00000000 00000000 00000000 AXIT..... POss3> ctuetenke sagan as 


Figure 68. yoe Internal Trace Records in TPRINT Output (MODE = EXT) 
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Module Names in Internal Trace Records 
Many VTAM internal trace records include the associated module names in EBCDIC, 
without the Ist prefix and the sixth letter. For example, you would see TSSR for 
module isttscsr. You can save time by scanning for these module names when 
you are following the logic flow through vTAmM. You can sometimes isolate a VTAM 
problem to a specific component or module without even looking at a dump. 


The first two letters in the module name, as it appears in a trace record, are the 
component ID for the module. vTAM component !Ds are listed below: 


ID VTAM Component 

AC Activation (configuration services) 

Al Application program interface (Apt) 

AP Process scheduling services (PSS) 

AT pss termination 

‘AU Authorization or accounting exit routine 

CD Cross-domain resource manager (CDRM) 

CF Display, network operator command facilities 
co LU 6.2 contro] operator 

CP sscP functions 

DE Deactivation (configuration services) 

ES Execution sequence control (ESC) 

HS Lu 6.2 half-session 

IN Initialization/Termination 

Lu Logical unit services (LUS) 

MA Maintenance services 

MG Management services 

NA Network address management 

NO Network operator command facilities (NOCF) 
NR Network resource manager (NRM) 


NS LU 6.2 logical network services 
oc OPEN/CLOSE 


OR Storage management services (SMS) 

PD Problem determination 

PS LU 6.2 presentation services 

PU Physical unit services (PUS) 

RA Trace, reliability, availability, serviceability (RAS) 
RM LU 6.2 logical resource management 

SD System definition 

sQ inquire 

Ss Session Services 

TS Transmission subsystem component (TSC) 
ZB Error recovery 
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SNAP Trace Record 
Besides recording the previously mentioned functions, you can use the viT to 
record 32, 64, 96, or 128 bytes of user-generated information in a SNAP trace. This 
SNAP trace can place additional information into a vtam module that might be useful 
in resolving a VTAM problem. The vit records the specified bytes and enters the 
data as a SNAP trace entry in the internal trace table or in the external trace file. 


Unlike other trace entries, you do not specify the SNAP trace as an option of the 
MODIFY command. Instead, you must follow these steps: 

1. Insert a record to check that ATCLCPTR is not 0. 

2. Insert a record to check that ATCRACTRA is not 0. 


3. Insert a call to the internal trace recording routine (ISTRACTR) in a VTAM module. 
(Field ATCRACTR in the ATCVT points to the trace recording routine. See VTAM 
Data Areas for the hex offset.) 


Note: SNAP records cannot be taken during the early stages of VTAm initialization, 
nor can they be taken during the late stages. 
The snap trace requires the following information in registers 1, 14, and 15 on entry 


to the trace routine: 


Register 1 
Points to the 32, 64, 96, or 128 bytes to be recorded. 


Register 14 
Points to a 2-byte input flag field containing: 


e X'141C' for a 32-byte SNAP entry 
e X'142C' for a 64-byte SNAP entry 
¢ X'143C' for a 96-byte SNAP entry 
e X'144C' for a 128-byte SNAP entry. 
These flags tell the trace recording routine to record a SNAP trace. 


Two Bytes Past the Address in Register 14 
Is the return address to the vTAM module that called the trace recording 
routine. 


Register 15 
Points to the SNAP trace recording routine (ISTRACTR). 


When the trace recording routine returns control to the calling module, the contents 
of register 6 are unpredictable. The contents of the other registers, however, are 
not changed. 


The SNAP trace record is unformatted. You should format the first 4 bytes of the 
SNAP record for a 1-to 4-character EBCoIC record identifier (for example, C'AscD’). 


Note: The 1-to 4-character EBCDIC record identifier should not match any existing 
vit record identifier. 
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Deactivating the Internal Trace 


You can stop one or more of the active viT options by issuing the MODIFY NOTRACE 
command with TYPE-VTAM specified. You can specify which traces are to be 
stopped using ihe OPTION operand. 


If you specify OPTION=ALL, all active viT options are stopped, but the internal trace 
table is not freed. Exceptions are still recorded during this idle period. 


If you specify OPTION=END, all active viT options are stopped, and the internal trace 
table is freed. 


For complete descriptions of the MODIFY TRACE and MODIFY NOTRACE commands, and 
Start options for the viT, see VTAM Operation. 


Internal Trace Record Summary 


VM Abend SNAP 


LU 6.2 Authorized !O or 
LU 6.2 TPIO (Part 1) 


LU 6.2 Authorized IO or 
LU 6.2 TPIO (Part 2) 


LU 6.2 User Post or LU 
6.2 RPL Exit (Part 1) 


The following chart lists all viT entries alphabetically by record Ip. For detailed 
descriptions of the trace records, see “Internal Trace Record Descriptions” on 
page 338. 


Note: A zero (0) in a trace record field means that field is not used by VTAM. 


OVOlOJO/OOO/OJO;O;O;O;OJO;O;O;Li DL LyLpridyiplylpdylyljdydyl 
OV1}2)3}4 {5/67 |B 9iAIBIC DIE; FIO; 1{ 2134 4)5)6)7) 8/9] A; B\C{DIE]F 


ABND CODE |PST SDWA {ABEND PSW or Q 
ADDRESS|ADDRESS|ADDRESS| FLAGS 
or 0 
L CiQ RPL APPCCMD|CONV ID] SENSE 
DRESSIN|U AREA {FLAGS 
TIA USR FLD! or 0 
RIL 
L 


RETURN |MODE NAME or Q LOCAL LU NAME |REMOTE LU NAME 
or 0 or Q 


R {|APPCCMD|CONV ID} SENSE 
C |FLAGS jor 0 DATA 
S or 0 
E 

C 
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LU 6.2 User Post or LU 
6.2 RPL Exit (Part 2) 


LU 6.2 User Exit (Part 1) 


LU 6.2 User Exit (Part 2) 


VM VSEAdapter (Part 1, 
for V3R1.2 and later) 


VM VSEA dapter (Part 2, 
for V3R1.2 and later) 


VM VSEAsynchronous 
Dispatch 


MVS VMAuthorized IO 
(Part 1) 


MVS VMAuthorized IO 
(Part 2) 
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EXIT 


ADDRESS 


IT} CUA | TSCB NCB CVAIIISIFIE DATA FIELD 
D ADDRESS | ADDRESS |B|CjNIL}RIN 

T}K}D}P|N|D 

D Ty T 


| RsrelgARE 


MODE NAME or 0 
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1|1 


bbe abs ba 
5/6\7\/8/9|A|BICIDIE|F 


RPL 
RECORD 
LENGTH 


PLU NAME SLU NAME or 0 
or 
APPLICATION ID 


<~O ar 


DATA FIELD 


ADSP {I PSI 
D ADDRESS 


O}RPL NIB RIS|VIVIC}RU OPTC2 | OPTC3 
P}ADDRESS| ADDR HIRITI THI CNTL 
T or CID |3/T{FIFIN{CODE 
] t 
l 


TPPOSTD| NORMAL | TPPOSTD | NORMAL 


ou< HWM 
momma 


RETURN |LOGON MODE NAME|PLU NAME SLU NAME 


ADDRESS 


(if available) |(if available) 
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false else ole lolillalalolelrlelalalalelolel 


MVS VM Authorized 1O 
(Part 3) 


MVS YM Abend 
RELSTORE 


MVS Attention 


Vt VSE Asynchronous 
Exit 


SSCP (RUPE — Part 1) 
RETURN 
ADDRESS| ORIGIN DESTINATION 
NETWORK {NETWORK 
ADDRESS {ADDRESS 


SSCP (RUPE — Part 2) 


FIRST 24 BYTES OF RU 


SSCP (NCSPL — Part 1) 
DESTINATION 

ADDRESS | OPCODE NETWORK 

ADDRESS 
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olololololololeloljolololololojojijiajaiijijal2 Jeeps a 
Ol121Z14ISI6I7IBIQIAIBICIDIE(F1O11)2/314|5/6|7/8{9/A|BiC{DIE|F 


CC2 |C] RDTE CPCB 
B] STATE | WID 
I 
D 


SSCP (NCSPL — Part 2) 


SSCP (not RUPE or 
NCSPL) RETURN | CPCB CPCB CPCB 
ADDRESS|OPCODE |WORD 3 |WORD 4 


SSCP (RUPE) 
RUPE RUPE 
ORIGIN DESTINATION 
NETWORK 
ADDRESS 


SSCP (NCSPL) 
RETURN |CPCB 
ADDRESS | OPCODE DESTINATION 
NETWORK 
ADDRESS 


SSCP (not RUPE or 


NCSPL) cPpcB.  |CPCB 
WORD 3 |WORD 4 


SSCP (RUPE) 
24 BYTES OF RU 
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ffl el olalleloelelalelsalsllrlalalalaelolel 


C} RDTE CPCB 
B} STATE | WTD 
I 

D 


SSCP (NCSPL) 


SSCP (not RUPE or 


NCSPL) C12 Ic 
or |B 

C02 {I 

D 


SSCP (RUPE, NCSPL, 
or not RUPE or NCSPL) 


PCID FOR THIS 
REQUEST 


STB PLU NAME SLU NAME 
ADDRESS 
SSCP (RUPE, NCSPL, 


or not RUPE or NCSPL) PCID IN PLU NETID SLU NETID 


PREVIOUS 
REQUEST 

HALCB | PUT 

ADDRESS | ADDRESS 
CPPURGE or CPPOST 
with EID or URC (Part 1,/ CPPG |I/C{/T|O}LOQAB DATA {RETURN | FIRST 12 BYTES OF EID 
for V3R1, V3R1.1, and or D|O1Y|-|ADDRESS ADDRESS or URC 
we) CPPT PL 
E/E 
N 


CONN |T CUA {GROUP 
I 
K 
CPPURGE or CPPOST 
(Part 2, for V3R1, CPP2 ADDITIONAL EVENT IDENTIFIER FOR CPPOST/CPPURGE 


VSE SHM Connect 


= Fznnm 
=z=onn= Uv 
— NM XI WM 


V3R1.1, and V3R1.2) 


(if needed) 
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o|0|0}0|0)ala/0/elojolo|o/alalay1)}z)2/a)2] fa a a a eee 

OILIZIZI4ISIGI7ISIDIAIBIC|DIETFIO(1/2/314/5/617/8|9/AIBIC|DIE|F 
CITJO/LQAB |WREDATA|WORK OPC IN |SAVE SENSE 
O|Y{PIADDRESSIIN WRE |ELEMENT}WORK AREA ID} DATA 
DIPIT or 0 
EIE 

CPPURGE or CPPOST 


(Part 3, for V3R2) FIRST 24 BYTES OF EID 


CPPURGE or CPPOST 
for PVI or Non-PVI 
Event (Part 1, for V3R2) 


CPPURGE or CPPOST 
(Part 2, for V3R2) 


CPPURGE or CPPOST 


(Part 4, for V3R2) CPP4 FIRST 24 BYTES OF RU or 0 po 


CPRC (Part 1) 
RUPE RUPE 
ORIGIN DESTINATION 
NETWORK |NETWORK 
ADDRESS {ADDRESS 


CPR2 {RETURN RUPEURC 
ADDRESS 
CPWAIT (Part 1, for 


V3R1, V3R1.1, and WREDATA| WORK FIRST 8 BYTES 
V3R1.2) IT}ADDRESS|IN WRE | ELEMENT | WORK OF CPCBURC 


CPRC (Part 2) 


ADDRESS | ELEMENT 


CPWAIT (Part 2, for 


V3R1, V3R1.1, and CPW2 {RETURN FIRST 24 BYTES OF EID 
V3R1.2) ADDRESS 
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ales elslelsalslaleloleelol:lzlolelslelelalall clo 


Non-PVI Events (Part 1, WREDATA| WORK OPC IN |SAVE 
for V3R2) D ADDRESS} IN WRE | ELEMENT | WORK 
ADDRESS} ELEMENT |}or 0 


CPWAIT (Part 2, for 
V3R2) RETURN RUPEURC or 0 
ADDRESS 


CPWAIT (Part 3, for 
V3R2) FIRST 24 BYTES OF EID 


CPWAIT (Part 4, for 
V3R2) CPW4 FIRST 24 BYTES OF RU or 0 


VSE SHM Disconnect 
DISC |TIC}PIS CUA |GROUP |HALCB- | PUT 
TiFIMIH ADDRESS | ADDRESS 
KIS|FIS 
MIS{I 
M 
PAB Dispatch (Part 1, 


for V3R1, V3R1.1, and PST PAB MODULE |RPH 
V3R1.2) A |ADDRESS| ADDRESS | ELEMENT | CHAIN 
B 


PAB Dispatch (Part 2, 
for V38R1, V3R1.1, and PAB EXTENSION or 0 
V3R1.2) 
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d/olojolalolololelojojololojojolalafaja{afafafajalafafajaya "P 
0}1)2{3}4)5]6]7|8)9 ale C\DIEJFIO}1)2)3)4)5}6}7/8)9;A/BIC| DIE} F 


PAB Dispatch (V3R2) 


Discarded PIU Buffer 
(Part 1) 


Discarded PIU Buffer 


(Part 2) MODULE 
ID 


Mvs Error Recovery 
CUA |NCB FLAG {FIC 
ADDRESS} BYTES |L{0 
A|D 
GIE 


Procedures 
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od BABY ba bt bp ob EE Ea EE 
OLIZIZ/41SI6/7ISIGIAIBICIDIEIFIO}1I2/3/4/516/718I9IAIBICIDIEIF 


moO a MmMmMwMm 


vm Error Recovery Pro- 
cedures (Part 1) I} CUA NCB |VIRTUAL| FLAG 
D ADDR |CAW BYTES 
CUA |NCB FLAG 
D ADDRESS| BYTES 


m”nA@ZzmMm 


NCB FLAG 
ADDRESS; BYTES 
NCB FLAG 
ADDRESS| BYTES 
NCB FLAG 
ADDRESS| BYTES 


vm Error Recovery Pro- 
cedures (Part 2) ERP2 0 DEVICE-DEPENDENT INFORMATION ZZ 


mo” 2Zz mm ms 


mn =z ™MmMmNM 
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ololololajajajaiafajafa]a 
clplE|Fjoj1{2|3/4|5]6}7|8{9{A}B|CjDIE|F 


0/0/0)0}0)0)0)0)0)0)0)0 
0)1}213)4)516}7)/8)9)A)B 
vse Error Recovery Pro- 


cedures (Part 1) VIRTUAL 
CAW 


NCB 
ADDRESS 
NCB 
ADDRESS 
NCB 
ADDRESS 
NCB 
ADDRESS 


vse Error Recovery Pro- 
cedures (Part 2) ERP2 jerec | 0 | —DEVICE-DEPENDENT INFORMATION = | DEVICE-DEPENDENT INFORMATION = DEPENDENT INFORMATION 


TPESC 


a) 
AN A =a Tm = nN rT 
AHO Yr wam 
moO =z mm moO az2mMmm 


AN XK 2 
AOoOY> Dam 


moon zw moo 1 ZX moo mm w 


PAB RETURN |RPH MODULE |RPH 
A |ADDRESS | ADDRESS | ADDRESS | WORK ADDRESS 


ELEMENT}or DVT 
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lifes elslealolalleloleelol:l2lelslalsolalallclolele 


TPEXIT 
PST RETURN } WORK MODULE {RPH 
ADDRESS | ADDRESS | ADDRESS | ELEMENT 
FREEBLK 
ADDRESS|RETURN |} LENGTH |CALLER | RETURN 
ADDRESS | OF 
GETBLK 
STORAGE | ADDRESS| RETURN {LENGTH |CALLER | RETURN 
ADDRESS ADDRESS | OF 
or 0 STORAGE 
REQUEST 
Halt I/O 


0} CUA |NCB FLAG 
ADDRESS| BYTES 
VM VSE Halt I/O (V3R1.2 


and later) NCB 
ADDRESS 


MvS Interrupt 
NCB FLAG |FICIS CSW 
ADDRESS| BYTES |LjQIE 
A|DIN 
GIES 0 
E 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 Chapter 8. Using the VTAM Internal Trace 325 


“Restricted Materials of IBM" 
Licensed Materials — Property of IBM 


ololelolololololololololololololij1jajai1jiji ee slelolele 
OLLIZIZI4ISIGITIBIDIAIBICIDIEIFIOI1I2Z131415/617 819 |AIBICIDIE|F 


vm Interrupt (Part 1) 
SENSE STATUS CCW 


NCB 
ADDRESS 


NCB 
ADDRESS 


AN RK 2 IT 
moo oo) 


NCB 
ADDRESS 


AN XK =a rm 


NCB 
ADDRESS 


ENDING CSW 


=r HM 


mM Nm @Z@MmMmMMm mOm em m 


NCB 
ADDRESS 


INT2 DEVICE-DEPENDENT 
INFORMATION 


3+ O 


© 


CS ca 
TAS a4a [zane 


vm Interrupt (Part 2) 
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lalla lala) elclolelelalaelalalslelllolallclolele 


SENSE STATUS CCW 


NCB FLAG 
ADDRESS| BYTES 


NCB FLAG 
ADDRESS| BYTES 


vse Interrupt (Part 1) 


AO YP am 


NCB 
ADDRESS 


AO YP wm 


NCB ENDING CSW 


ADDRESS 


mOMm2aemMm 


VSE Interrupt (Part 2) 
| a DEPENDENT 
| a 


O}RPL OPTC2 | OPTC3 
: ADDRESS| ADDRESS ai 
CODE 
102 RETURN |LOGON MODE NAME|PLU NAME SLU NAME 
ADDRESS or 0 (if available) |(if available) 
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mvs vse TPIO Request 
(Part 2) 
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OLOLOlOLO/O]O/OlOJO;O/O/OO/OlO;LIL;LTJA;LyLplpLjaAjplydydyly. a 
O11/Z2/3/4/5/617)/S/9A/BIC|DIEJF IO} 1} 2/3] 4)5/ 6, 7/8] 9 {A; BIC DEF 


MVS VSE TPIO Request 
(Part 3) 


YVMTPIO Request (Part 
2) SLU NAME 
(if available) |(if available) 


VM TPIO Request (Part 
3) 


MVSIRB Dispatch 


PST 
SYNC 
NORMAL 
QUEUE 
MVSIRB Exit 
IRB 
ADDRESS 
VM VSELAN 


Interface CUA |TSCB NCB 
Control D ADDRESS | ADDRESS 
(V3R1.2 and later) 


CUA | TSCB NCB REASON 
ADDRESS | ADDRESS 


fy : . 
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alalalstele lel Stor sl leteteyefeysy sy et342]3)2|4/2] 2/2] ]2]2) 
O]1]2/3/4/516/7/8/9fAIBICIDIEIFIO|1/2/3/415/617/8I9lAlBICIDIEIF 


LKEX L L}LOCK CRA RETURN LOCKWORD RPH 
QO E;/ADDRESS| LKACT |ADDRESS ADDRESS 
CV 
KE 
L 
LKSH L} LOCK CRA LOCKWORD 
E}ADDRESS| LKACT |ADDRESS 
V 
E 
L 


LOST pe REG 14 LOST TRACE RECORD 


MSG QO |S|SAVE MSG ID|RETURN |MODULE DESTINATION 
o| AREA ADDRESS | ID 
r| ADDRESS 
U 
MSGS {1 DESTINATION {MESSAGE} FIRST 12 CHARACTERS 
D HEADER OF MESSAGE TEXT 
TPMSG or CPMSG (Part 
2 for both MSG and MSG2 VARIABLE DATA or MORE MESSAGE TEXT 
MSGS) 


LU 6.2 Message Unit 
MU1 MU HS ID {CORR R AMU SENSE 
ADDRESS ADDRESS/E FLAGS | DATA 
T or Q 
C 
D 
LU 6.2 Message Unit 


(Part 1) 
(Part 2) MU ID|DATA SES}SES]| CONV 
ADDRESS;LENGTH |ADDRESS!CNT|LIM} ID 


TPLOCK Exclusive 


TPLOCK Shared 


AO) © re 


Lost Trace Record 


TPMSG or CPMSG (Part 
1) 


Message Sent Record 
(Part 1) 


or jor | or Q 
0 {0 
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o|0 


ololololololelolelojoje JHA RPA BRERA Re 
011/21314/516/7/SI9|AIBIC[DIE| F/O] 1)2/3}4|5|6|7 (8/9 jA|BIC|DIE|F 


LU 6.2 Message Unit 
(Part 3) wus ]o|mu 10] mo0e nane or 0 MODE NAME or 0 | LOCAL LU NAME LU NAME [Local Lu nave [REMOTE LU NAME LU NAME 
Negative Response to a 
PIU Request (Part 1) NRSP I}CiF 20 BYTES OF PIU 
D|}BiL} |ADDRESS 
IA 
D|G 
S 
Negative Response to a 
PIU Request (Part 2) 24 MORE CHARACTERS OF THE PIU RETURN 
ADDRESS 


Operator Command 
(Part 1) FIRST 24 CHARACTERS OF OPERATOR COMMAND 


Operator Command 

(Part 2) OPE2 UP TO 28 MORE CHARACTERS OF THE OPERATOR COMMAND 
VM VSE Packet Interface 

(V3R1.2 and later) PIC INTERNAL TRACE DATA 


PIU Record (Part 1) 
20 BYTES OF PIU 


PIU Record (Part 2) 


VM VSE Packet Inbound 
or FIRST 20 BYTES OF THE PACKET 
Packet Outbound 
(V3R1.2 and later) 
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OO/O/O/O/OOO/O/O/OO/O;OlO/OlLILiLiasdiriasaiaiaizsialaliaialy 
O1LIZ/3/4) 516/718 9AIBICIDIEIFIOl1IZ/314/516I7ISI9/AIBICIDIEIF 
VM VSE Packet 


Extension ADDITIONAL BYTES OF PACKET 
(V3R1.2 and later) D (if needed) 


TPPOST 
PST RETURN |WORK DVT RPH 
ADDRESS | ADDRESS | ADDRESS | ELEMENT | ADDRESS | ADDRESS 


MVS VM Queued 
REQSTORE BUFFER 


ADDRESS | ADDRESS 


TPQUE (Part 1, for 
V3R1, V3R1.1, and PST PAB MODULE |RPH 
V3R 1.2) ADDRESS | ADDRESS | ELEMENT | FIELD 


TPQUE (Part 2, for 
V3R1, V3R1.1, and RETURN PAB EXTENSION or 0 
V3R1.2) ADDRESS 


G} PST PAB RETURN | WORK MODULE |RPH 
A} ADDRESS | ADDRESS | ADDRESS | ELEMENT | NAME 

T ADDRESS|or DVT jor 0 
E ADDRESS 


PST QUEUE |RETURN | WORK 
ADDRESS 


TPQUE (V3R2) 


OO > remn 


TPQUE None 


or 0 
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0|9{9)8]9/0/a{9/o/a{0/o/ayalofayr) ajay) aaa eee alele 
OLIZIZIAISIGITISIQIAIBICIDIEJFIOI1/ 213 4I5/6171SI9/A|BICIDIE|F 


RCE (V3R2) 
RETURN |OUT1 or|OUT2 or|DATA 
ADDRESS 

RPL Exit 

RELSTORE 


I] PST BUFFER | RETURN 
D| ADDRESS | ADDRESS | ADDRESS 


REQSTORE 
NUM REG 1 |RETURN 
BUF CODE 
REQ 


Resume from TPWAIT 
PST 
ADDRESS | ADDRESS | ELEMENT | ELEMENT | ADDRESS | ADDRESS 


TPSCHED (Part 1, for 
V3R1, V3R1.1, and MODULE |RPH 


V3R1.2) ADDRESS | ADDRESS | ELEMENT 
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1|1 
0] 1 


OR ROR RCH RCH ACH RCH RCHECHECHRCRECHECHRCRECHECHEC 
O}1,2)3|4]/5]6]7{8/9/A]BIC|DIEIF 


Lee Ee ae) ad 
213/415/617/8/9)AIBICIDIEF 
TPSCHED (Part 2, for 


V3R1, V3R1.1, and PAB EXTENSION or 0 
V3R1.2) 


TPSCHED (V3R2) 
N1G}PST PAB RETURN |WORK MODULE |RPH 
0}A} ADDRESS | ADDRESS | ADDRESS | ELEMENT | NAME ADDRESS 
Py T or DVT 
E ADDRESS 
mvs Start I/O (Part1) 
Wi CUA |NCB FLAG CCW or 
R ADDRESS| BYTES DEVICE- 
I DEPENDENT 
T INFORMATION 
E 


TH COO = 


Tn OO = 


CUA {NCB FLAG CCW or OUTPUT 
ADDRESS| BYTES CONTROL AREA 
(STATUS 
INFORMATION) 


Mvs Start I/O (Part 2) 
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0|0]0/0}0|0|0/a)0[0/0)0)0/o/o)a) fa ia) a aia ya ta yAlelelolele 
Ol1LIZIZI4ISIGI7TISIDIAIBICIDIEIF/O11/213/4/516)7/8I9|A|BIC|DIE;F 


DUMP OF WRITE CONTROL AND READ CONTROL 
DATA AREAS 


vm Start [/O (Part 1) 


— 
Co 
oe 
> 
me] 


=nnmn 


NCB 
ADDRESS 


NCB 

ADDRESS 

NCB 

ADDRESS 

NCB CCW or OUTPUT 

ADDRESS CONTROL AREA 
(STATUS 
INFORMATION) 


DEVICE-DEPENDENT INFORMATION 
or 0 


M 
0 
D 
I 
D 
M 
0 
D 
I 
D 
M 
0 
D 
I 
D 
M 
0 
D 
I 
D 


VM Start I/O (Part 2) 
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O/O;O;O;O/O;O;O/O;O;O;O;O/O;O/O; LiL] APL] LpAs TPL; 1{ asa; i_yasyzyafa 
OJ1]2) 3; 4) 5] 6) 78/9 ABI C|DIE}FiO;1)/2)3)4/5/6}7/8/9/AIBIC|DIE|F 


VSE Start I/O (Part 1) 


DUMP OF WRITE CONTROL AND READ CONTROL 
DATA AREAS 


CUA |NCB FLAG 
ADDRESS| BYTES 

CUA {NCB FLAG 
ADDRESS} BYTES 

CUA |NCB 
ADDRESS 


DEVICE-DEPENDENT INFORMATION 
or 0 


ZFnnwva 


Pour vo vu 


VSE Start I/O (Part 2) 


MVS SRB Dispatch 
PST TCB F 
ADDRESS | ASYNC ASYNC |ADDRESS| L 

N-DISP 

QUEUE 

(ANDSP) 


MVS SRB Exit 


ADDRESS | ASYNC 


ADDRESS | ADDRESS 
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edb bbl db bby ab ot Et al bb 
OLLIZIZI4ISIGI7ZISIQIAIBICIDIELFIO/1/ 21314151617 |SI9|AIBIC|DIE|F 
SRTCHG (V3R2 only), 


SRTADD, SRTDEL, HASH NAME RETURN | SRT NETWORK ID 
SRTFIND (NAME or ADDRESS | ENTRY 

NETWORK 

ADDRESS) 


USER Exit (DFASY or 
RESP) 


USER Exit (Part 1, not 

DFASY or RESP) EXIT-TYPE PRIMARY SECONDARY 
DEPENDENT (APPL) LU NAME 
INFORMATION LU NAME or 0 


USER Exit (Part 2, not 


DFASY or RESP) 
TPUNLOCK All 
TPUNLOCK 
UNLK L L}LOCK CRA 
0 E/ADDRESS| LKACT |ADDRESS 
CV | 
KE 
L 
User Post 
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OO/O/O/O/O/O/O/O/O;O;O/O/O/O/OsLiTILyT)1)LyLyLyaylp2yzyazypijiji 
0} 142}3)4)5]6|7/8/9;A|BICIDO/ EJF LO} 1)2/3);4]5|6)7/8/9|A|BIC| DIE] F 


VTALLOC 
STORAGE | SUBPOOL| RETURN | LENGTH {CALLER | RETURN 
D ADDRESS |NUMBER {ADDRESS CODE 


VTFREE 


TPWAIT 


RPH 
ADDRESS 
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Internal Trace Record Descriptions 


This section describes the vTAM internal trace table records. 


On each entry, the description called “Applies to” tells which operating 
systems the entry is valid for. For mMvs and vM, V3R1.1, V3R1.2, and V3R2 are 


implied unless it is stated specifically that the entry is for one or two 
releases. For VSE entries, V3R1, V3R1.2, and V3R2 are implied unless it 
clearly specifies that the entry is for one or two releases. 


vm Abend SNAP 


Entry: VM ABND 

ViT Option: None (Generated by SNAP routine) 
Event: Abend 

VIT Processing Module: ISTRACTR (SNAP trace recording routine) 
Control is Returned to: ISTAPCES 

Applies to: VM 


This trace record is written when an abend occurs on a process that has been dis- 
patched by pss. This entry is not associated with any vit options, but is recorded 


as an exception condition when an abend occurs. 
O;O/O/O;O/O/O/O/O/OO/Os;O/O;O;O} 1s] 1} 1; 14; 1414141 
01, 2)3/4/5|6]7/8/9/A]BIC/D/E;FI0/1/2/3)415/6}7 

SDWA |ABEND PSW or 0 


ABND CODE |PST RPH 
ADDRESS} ADDRESS | ADDRESS} FLAGS 


or 0 
Byte (hex) Contents 
00-03 Record !D: C‘ABND' 
04-07 Abend completion code 
08—-OB PST address 
OC — OF RPH address 


1 
B 


1 
C 


1 
E 


1 
8 


1 
9 


l 
A 


1 
D 


] 
F 


10-13 SDWA address or zero 
14-17 SOWA flags or zero 
18—1F Abend Psw or zero 


338 VTAM Diagnosis LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


ACA1 or ACI1 


LU 6.2 Authorized IO or LU 6.2 TPIO (Part 1) 


Entry: 
VIT Option: 
Event: 


viT Processing Module: 
Control is Returned to: 


Applies to: 


The Acai trace record shows LU 6.2 requests under the authorized path or Lu6.2 


ACAT1 or ACI1 

APPC 

LU 6.2 authorized IO or LU 6.2 TPIO (Part 1) 
ISTRACAC 

ISTAICAR 

Mvs (V3R2), vm (V3R2), VSE (V3R2) 


requests not under the authorized path but issued by programs running under an 
authorized key. The Aci1 trace record shows Lu 6.2 requests running under a 


normal path. 


ACAL |{I/E/0;}0 
or D|X 
ACI1 T 

D 

S 


OOO/O/O/O;O;O/O;O/O;O;O;O;O;Of{ LiL; LPL yA Lplpljdj@pljlyi_yqy). 
O}1)2)3)4) 516} 7/B/9jAIBiCIDIE}F/O}142)3)4)/5)6)7 8, 9jAIBICIDIE|F 


RPL CiQ RPL APPCCMD}CONV ID] SENSE 
ADDRESS | N|U AREA {FLAGS 
A USR FLD] or 0 
L 


—- AD -aA 


Byte (hex) Contents 


00-03 


Record 1D: 


¢ C'acai’ for authorized path 
e C‘aAcI1’ for normal path 


04 iD 


e For mvs, address space !D 
(or zero if address space ID is greater than X'FF') 
e For vm, machine and task ID 
¢ For VSE, task ID 
05 Exit definition (RPLEXTDS) 
06 Option code byte 1 (RPLOPT1) 
07 Option code byte 6 (RPLOPT6) 


08 —- 0B 


RPL address 


0C APPCCMD CONTROL parameter value: 


X'10' 
X' 20! 
X'30' 
X'40' 
X'50' 
X'60' 
X'70' 
X'80' 
X'90' 


ALLOC 
RESETRCV 
DEALLOC 
OPRCNTL 
PREPRCV 
RCVFMH5 
RECEIVE 
REJECT 
SEND 


OD APPCCMD QUALIFY parameter value: 


X01! 
X'02' 
X03 ' 
X04 ' 
X'05' 
X'06' 
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ABNDPROG 
ABNDSERV 
ABNDTIME 
ABNDUSER 
ANY 

CNOS 
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OE — OF 
10-13 
14-17 
18—1B 


1C—1F 


X'07' CONFIRM 
X'08' CONFRMD 
X'09' DATA 
X'OA' DATACON 
X'OB' DATAFLU 
X'OC' DEFINE 
X'OD' DISPLAY 
X'OE' ERROR 
X'OF' FLUSH 
X'10' RQSEND 
X'11' SPEC 
X'12' ACTSESS 
X'13' DACTSESS 
X'14' ALLOCD 
X'15' IMMED 
zero 
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Address of SEND data or RECEIVE buffer 
APPCCMD flags (RPL6FLGS) 
User field for LU 6.2 commands where CONTROL equals ALLOC or 
RCVFMH5. CID for LU 6.2 commands where CONTROL equals OPRCNTL and 
QUALIFY equals either ACTSESS or DACTSESS. Zero for LU6.2 commands 
for which one of the following is true: 

¢ CONTROL equals OPRCNTL, and QUALIFY equals CNOS, DEFINE, or 

DISPLAY 
¢ CONTROL equals RECEIVE and QUALIFY equals ANY. 


Conversation ID for all other LU 6.2 commands. 
Sense data (RPL6SNSO) or zero 
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LU 6.2 Authorized IO or LU 6.2 TPIO (Part 2) 


Entry: ACA2 or ACI2 

viT Option: APPC 

Event: LU 6.2 authorized IO or LU 6.2 TPIO (Part 2) 
viT Processing Module: ISTRACAC 

Applies to: MVS (V3R2), VM (V3R2), VSE (V3R2) 


The ACA2 trace record is a continuation of ACA1. The ACi2 trace record is a continua- 


LyLylydylplylylydylyijajlyij.)2 
O}1}2)3)4)5]6]7 18/9; A|BIC|DIE}F 


tion of ACI1. 


LOCAL LU NAME |REMOTE LU NAME 


Byte (hex) Contents 
00-03 Record ID: 


¢ C‘ACA2’ for continuation of authorized path for ACA1 
e C'‘AcI2’ for continuation of normal path for acit 


04-07 Return address of the issuer of the APPCCMD macro 


08 — OF Mode name for LU6.2 commands where CONTROL equals ALLOC. Mode 
name for LU 6.2 commands where CONTROL equals OPRCNTL and QUALIFY 
equals CNOS, DEFINE, or DISPLAY. Zero otherwise. 


10-17 Local logical unit name for Lu 6.2 commands where CONTROL equals 
ALLOC. Local logical unit name for LU 6.2 commands where CONTROL 
equals OPRCNTL, and QUALIFY equals CNOS, DEFINE, Or DISPLAY. Zero oth- 
erwise. 


18—1F Remote logical unit name for Lu 6.2 commands where CONTROL equals 
ALLOC. Remote logical unit name for LU 6.2 commands where CONTROL 
equals OPRCNTL, and QUALIFY equals CNOS, DEFINE or DISPLAY. Zero oth- 
erwise. 
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ACP1 or ACR1 


LU 6.2 User Post or LU 6.2 RPL Exit (Part 1) 


Entry: ACP1 or ACR1 

viT Option: APPC 

Event: LU 6.2 user post (ACP1) or LU 6.2 RPL exit (ACR1) (Part 1) 

viIT Processing Module: ISTRACAC 

Control is Returned to: ISTAICPT and ISTAPCSX for ACP1; ISTAPCSX and ISTAPCUE for 
ACR1 


Applies to: mvs (V3R2), vm (V3R2), vSE (V3R2) 


The acpi trace record is written when an ECB is posted, signaling that the APPCCMD 
macro has completed execution. This trace record shows the data returned to the 
user application program. 


The Acai trace record is written when an RPL exit is dispatched, signaling that the 
APPCCMD macro has completed execution. This trace record shows the data 
returned to the user application program. 


Q;O;O;O/O;O/O/O;O/O;O/O;O;O;O;O; TL) AL; LiLiLiLylLyaydyljijlyiyiyl 
O}1}2)3)4)516)7/8/9 AI BiCIDIEJF/O}1)2;3)4) 5/6) 78/9 AI BIC} DIE] F 


R |APPCCMD{CONV ID| SENSE 
C |FLAGS jor Q DATA 
S or 0 


mH Oo 0 7 


Contents 
Record ID: 
e C'ACP1’ for ECB posting 
¢ C'ACR1’ for RPL exit dispatching 
04 ID 
e For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For vM, machine and task ID 
e For VSE, task ID 
05 APPCCMD returned indicators (RPL6RTUN) 


Byte (hex) 
00-03 


Bit 0 FMH5 received indicator 
Bit 1 LOGON received indicator 
Bit 2 SIGNAL received indicator 
06 VTAM return code (RPLRTNCD) 
07 VTAM feedback code (RPLFDB2) 
08—0OB RPL address 
OC APPCCMD CONTROL parameter value: 
X'10' ALLOC 
X'20' RESETRCV 
X'30' DEALLOC 
X'40' OPRCNTL. 
X'50' PREPRCV 
X'60' RCVFMHS5 
X'70' RECEIVE 
X'80' REJECT 
X'90' SEND 
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0D 


OE —OF 
10-11 

12-13 
14-17 
18—1B 
1C—1F 
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ACP1 or ACR1 


APPCCMD CONTROL parameter value: 


X'01' 
X'02' 
X'03' 
X'04' 
X'05' 
X'06' 
X'07' 
X'08' 
X'Q9' 
X'0A' 
X'OB' 
X'0C' 
X'OD' 
X'0E' 
X'OF' 
X'10' 
X'11' 
X12! 
X'13' 
X'14' 
X'15' 
Zero 


ABNDPROG . 


ABNDSERV 
ABNOTIME 
ABNDUSER 
ANY 
CNOS 
CONFIRM 
CONFRMD 
DATA 
DATACON 
DATAFLU 
DEFINE 
DISPLAY 
ERROR 
FLUSH 
RQSEND 
SPEC 
ACTSESS 
DACTSESS 
ALLOCD 
IMMED 


LU 6.2 primary return code (RPL6RCPR) 
LU 6.2 secondary return code (RPLERCSC) 


APPCCMD flags (RPL6FLGS) 
Conversation ID or zero 


Sense data returned (RPL6SNSI) or zero 
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ACP2 or ACR2 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


LU 6.2 User Post or LU 6.2 RPL Exit (Part 2) 


344  VTAM Diagnosis 


Entry: ACP2 or ACR2 

vit Option: APPC 

Event: LU 6.2 user post (ACP2) Or LU6.2 RPL exit (ACR2) (Part 2) 
vit Processing Module: ISTRACAC 

Applies to: MVS (V3R2), VM (V3R2), VSE (V3R2) 


The ACP2 trace record is a continuation of the ACP1 trace record. The ACR2 trace 
record is a continuation of the ACR1 trace record. 


O;O;O;O/O;O;O/O;OsLiL)Lyljdjijij2 
7\8\9|A\ByCIDJE] FIO} 1) 2) 3)4)5)6)7 


Byte (hex) 
00 —03 


04-07 


08 — 0B 
0C 


OD 
OE — OF 


10-13 
14-17 
18—1F 


RPL6 C 
ADDRESS | ADDRESS |N RECORD 
or q LENGTH 
EXIT R 
ADDRESS L 


Contents 
Record ID: 
e C'acp2' for continuation of ACP1 
e C'ACR2 for continuation of ACR1 
ECB address for ACP2 
RPL exit address for ACR2 
RPL6 address 
APPCCMD CONTROL parameter value: 
X'10' for ALLOC 
X'20' for RESETRCV 
X'30' for DEALLOC 
X'40' for OPRCNTL 
X'50' for PREPRCV 
X'60' for RCVFMH5 
X'70' for RECEIVE 
X'80' for REJECT 
X'90' for SEND 
Zero 
Indicators for the type of information received, or zero 
Bit 0 DATA 


Bit 1 DATA_COMPLETE 
Bit 2 DATA_INCOMPLETE 
Bit 3 SEND 

Bit 4 CONFIRM 

Bit 5 DEALLOCATE 


Address of SEND data or RECEIVE buffer 
RPL record Jength 
Zero 
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“Restricted Materials of IBM” ACU1 
Licensed Materials — Property of IBM 


LU 6.2 User Exit (Part 1) 


Entry: ACU1 

VIT Option: APPC 

Event: LU 6.2 user exit (Part 1) 

vit Processing Module: ISTRACAC 

Control is Returned to: ISTAPCUE 

Applies to: Mvs (V3R2), vm (V3R2), vse (V3R2) 


This trace record is written when an LU 6.2 user exit (either ATTN or TPEND) is dis- 
patched. If both the Api and APPC trace options are active, and a TPEND user exit is 
dispatched, vTAM generates user exit trace records for both ap! and APPC. 


O;O;/O/O/O/O;O/O/O/O;O;O;O;O;O;O;LIL{L)LPL{Li@pLyl;Lplpdp@yi2}qyi 
O11) 2)/3)4) 516) 7/8) 9jAIBIC DIE} FIO} 1) 2)3)4)5)6)7/8/9)A| BIC DI EIF 


EXIT PLU NAME SLU NAME or Q 
TYPE or 
DEPEND APPLICATION ID 


INFO 


Byte (hex) Contents 
00-03 Record ID: C'Acu1 
04 ID 
e For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
¢ For vM, machine and task ID 
¢ For VSE, task ID 
05 Exit code for user exit: 
e X'OC' for ATTN 
¢ X'QD' for TPEND 
06 — 07 Zero 
08 —-OB For ATTN exit, the exit Sub-type (CNOS, FMH5, or LOSS) 
For TPEND exit, the reason code 
OC — OF Zero 


10-17 PLU name for ATTN exit 
Application program !0 for TPEND exit 
18-—1F SLU name for ATTN exit 


Zero for TPEND exit 
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ACU2 “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


LU 6.2 User Exit (Part 2) 


Entry: ACU2 

vit Option: APPC 

Event: LU 6.2 user exit (Part 2) 

viT Processing Module: ISTRACAC 

Applies to: Mvs (V3R2),vm (V3R2), vse (V3R2) 


This trace record is a continuation of the acu1 trace record. 
OOO/O/OO/O/O/OJO;O/O/O;O;O;O LILILTI LIL Ly Lilylyi ly lyayl{ijiii1 
OLLIZ213/4 5/6/7189 IABICIDIESFIO/1I2/314/5/61/7 1/819 AIBICIDIE|F 
ACU2 {EXIT MODE NAME or 0 

ADDRESS 


Byte (hex) Contents 

00-03 Record |b: C‘acu2’ 

04-07 Exit address 

08 — OF Mode name for ATTN exit; zero for TPEND exit. 
10—1F Zero 
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“Restricted Materials of IBM” ADP (V3R1.2 and later) 
Licensed Materials — Property of IBM 


vm vse Adapter (Part 1, for V3R1.2 and Later) 


Entry: vM VSE ADP 

VIT Option: ClO 

Event: Start 1/o 

viT Processing Module: ISTRAC6T 

Control is Returned to: ISTTSC6B 

Applies to: vM(V3R1.2 and later), vSE(V3R2) 


This trace record is created when a data transfer with the Token-Ring Subsystem is 
initiated or has completed. 


An ADPA record is written when the subsystem acknowledges that an outbound data 
transfer is complete. This entry always corresponds to a previous ADPO entry. Use 
the TscB field to correlate these entries. 


An AbDPI record is written when an inbound transfer has been received from the sub- 
system. An ADPi trace entry may be followed by one or more ADpP2 entries. 


An ADPO record is written when an outbound data transfer is complete. This entry 
always corresponds to a previous LICO entry. Use the TScs field to correlate these 
entries. An ADPO trace entry may be followed by one or more ADp2 entries. 


OO/O/O;O;O;O/O;O/OO;O/O;O;O;O;L LT;A; Li Lidplplflylpa_ylp ty tyafl 
Q0}1)2/314)5)6)7/8/9jA| BIC] DIE] F{O}1)2)3)4/5)6)7/8)9)A|BiC|DIE|F 


ADPA j|I| CUA |TSCB NCB CIA FIE DATA FIELD 
ADPI |D ADDRESS | ADDRESS | B}C RIN 
ADPO K N|D 

T 


Byte (hex) Contents 

00-03 Record ID: 
C'aoPa’ for an acknowledge record 
C'app!’ for an inbound record 
C'appo’ for an outbound record 


<~_O se 
oH4 Url wm 


04 Machine and task !D 

05-07 Channel device name in EscDic (either a CUA or device number) 
08—-0OB TScB address 

OC — OF NCB address 

10 Control block ID 

11 Index value acknowledged by subsystem 

12 Last index value presented to subsystem 

13 Last index value acknowledged by subsystem 
14 Index for the front pointer of the buffer ring 

15 Index for the end pointer of the buffer ring 
16-17 Zero 


18—1F Data field. 
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ADP2 (V3R1.2 and later) “Restricted Materials of IBM” 
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vm vse Adapter (Part 2, for V3R1.2 and Later) 


Entry: VM VSE ADP2 

VIT Option: CIO 

Event: Start 1/0 

vIT Processing Module: ISTRAC6T 

Applies to: VM (V3R1.2 and later), VSE (V3R2) 


This trace record is a continuation of the ADP! or ADPO entries. 
OOO /OOO/O/O/O;O;O;OOPLILILTI LIL LT LiL Lily iyi lily .yi 
OVLIZ2;Z/4)5/6/7/8/9{(ABICIDIELFIOI1LI2Z1/3/4/516/718/9/AIBICIDIE|F 


DATA FIELD 


Byte (hex) Contents 
00-03 Record ID: C‘ADP2’ 
04—1F Data field. 
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“Restricted Materials of IBM” vm vsE ADSP 
Licensed Materials — Property of IBM 


vm vse Asynchronous Dispatch 


Entry: vm vSE ADSP 

viT Option: PSS 

Event: Asynchronous dispatch 
VIT Processing Module: ISTRACPS 

Control is Returned to: ISTAPCAD 

Applies to: VM, VSE 


This trace record is written whenever PSS receives contro] because work has been 
scheduled (TREADY COND=VTAM). 


ie bb rl ant bia iene aprab nee 
tHe bb amb doe nA Abe AAP 
ADSP {I Pol 

D ADDRESS 


Byte (hex) Contents 

00-03 Record ID: C'ADSP’ 

04 ID 
e For vM, machine and task ID 
¢ For VSE, task ID 

05— 07 Zero 

08—0B PST address 

OC — OF Zero 


TPPOSTD| NORMAL | TPPOSTD | NORMAL 


10-13 Synchronous TPPOSTed queue (PSTSTPP) 
14-17 Synchronous normal queue (PSTSNRM) 
18-—1B Asynchronous TPPOSTed queue (PSTATPP) 
1C-—1F Asynchronous normal queue (PSTANRM) 
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=~ 


“Restricted Materials of IBM” 
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mvs VM Alt 


mvs vm Authorized IO (Part 1) 


350 ~=VTAM Diagnosis 


Entry: MVS VM Al1 
VIT Option: API 
Event: Authorized Io (Part 1) 
vit Processing Module: ISTRACAP 
Control! is Returned to: ISTAICIR for: ISTOCCSM for: 
SEND INQUIRE 
RECEIVE INTRPRET 
RESETSR RCVCMD 
SESSIONC SENDCMD 
SETLOGON 
SESSIONC (BIND) 
SIMLOGON 
OPNOST 
REQSESS 
OPNSEC 
TERMSESS 
CLSDST 
Applies to: MVS, VM 


The following trace record shows AP! requests under the authorized path or API 
requests not under the authorized path but issued by programs running under an 
authorized key. The AP! routine ISTAICIR or ISTOCCSM writes the entry and then 
queues the RPL to the correct PAB. See VTAM Data Areas for an explanation of the 


RPL fields. 


OO;O;O/O/O;O/O;O/O/O;O;O/O;OO;TL;LILILiLpljlylyayaydydpdiidy. 
O}1]/21/3/4) 5) 6) 7/8/9AIBIC DE] FIO} 1)2)3)4)5)6)7 18/9 /A/Bi CDE] F 


Byte (hex) Contents 

00-02 Record id: C'AIt’ 

03 RPL request type (RPLREQ) 
X'15' SETLOGON 
X'16' SIMLOGON 
X'17' OPNDST 
X'1A' INQUIRE 
X'1B' INTRPRET 
X'1F' CLSDST 
X'22' SEND 
X'23' RECEIVE 
X'24' RESETSR 
X'25' SESSIONC 
X'27' SENDCMD 
X'28' RCVCMD 
X'29' REQSESS 
X'2A' OPNSEC 
X'2C' TERMSESS 


OPTC2 | OPTC3 
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04 iD 
e For mvs, address space Id 
(or zero if address space ID is greater than X'FF') 
¢ For vm, machine and task ID 


05 Exit definition (RPLEXTDS) 
06 Zero 
07 Option code byte 1 (RPLOPT1) 


08 —0B RPL address 
OC — OF NIB address or CID 


10 Third byte of RH (RPLRH3) 

11 Send/receive type (RPLSRTYP) 
12 VTAM flags (RPLVTFL1) 

13 Post/respond flags (RPLVTFL2) 
14 RU chain position (RPLCHN) 
15-17 AU control codes (RPLCNTAL) 
18—-1B VTAM options (RPLOPTC2) 
1C—1F VTAM options (RPLOPTC3) 
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mvs vM Al2 


“Restricted Materials of IBM” 
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mvs vm Authorized IO (Part 2) 


352  VTAM Diagnosis 


Entry: mvs vm Al2 

vIT Option: API 

Event: Authorized Io (Part 2) 
viT Processing Module: ISTRACAP 

Applies to: MVS, VM 


This trace record is a continuation of the ai entry. It shows additional information 
about the PLU and SLU in a session established or terminated by a SIMLOGON, OPNDST, 
CLSDST, REQSESS, OPNSEC, Or TERMSESS macroinstruction. This information includes 
some of the parameters exchanged and the names of the PLU and SLU. 
0 : 1 
E|F 


OJO/O/O;O;OO/O/O/OO/OO;O;O/O;LILILILy ls Lidjlyi_yiyij1)i 

O11) 21;3/4/ 51/6/7819 AIBIC|DIE}F{/O/1)2/3/4/5/6}7/8/9]/AIBIC 

Al2 RETURN |LOGON MODE NAME}PLU NAME SLU NAME 
ADDRESS (if available) |(if available) 


Byte (hex) Contents 
00-02 Record 1D: C’al2: 


1 
D 


03 Zero 
04-07 Address of the issuer of the macro 
08 — OF For SIMLOGON, OPNDST, CLSDST, Or REQSESS: Logon mode name 


(NIBLMODE) or zero if the NIB is not available 
For OPNSEC Or TERMSESS: Zero 

10-17 PLU name or zero 

18—1F SLU name or zero 
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“Restricted Materials of IBM" mvs vm Al3 
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mvs vm Authorized IO (Part 3) 


Entry: MVS Viv 

vIT Option: API 

Event: Authorized 10 (Part 3) 
vIT Processing Module: ISTRACAP 

Applies to: MVS, VM 


This trace record is a continuation of the al2 entry. It shows additional information 

in a session established or terminated by a SIMLOGON, OPNDST. CLSDST, REQSESS, or 

OPNSEC macroinstruction. 
CHRCHRCHECRECHRORACHECH RCERCHRCHECRECRRORECHECH ID Lil}1ji}l 
OV LIZ) 3/4/5) 6/718) 9{AIBICIDIE} FIO 


elalalalela 


el EE 


Lj1jijl 
1}2}3 


Alsleh ' 


Al3 ADDRESS 
OF USER 
DATA, 
BIND, 
or 0 


Byte (hex) Contents 
00-02 Record iD: C'AI3’ 


03 Zero 

04-07 For SIMLOGON, CLSDST, or REQSESS: Address of user data (RPLAREA) 
For OPNDST or OPNSEC: Address of BIND (NIBNDAR) or zero if the NIB is not 
available 


08 — 1F Zero 
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mvs vm Abend RELSTORE 


354 VTAM Diagnosis 


Entry: mvs VM AREL 
ViIT Option: SMS 

Event: Abend RELSTORE 
vIT Processing Module: ISTRACSM 
Control is Returned to: ISTORAPR 
Applies to: MVS VM 


This trace record identifies the buffers that are released by VTAM when a VTAM 
application program is terminated. 


CHRCHACHRCHECHECH ACH ECHECHECHECHECHECHECHECEROH DG Um mam 
O1;2{ 3/4) 5) 6,78 9A| BCD E; FIO; 1) 243 


AREL jI|C PST BUFFER | RETURN 
D|B ADDRESS | ADDRESS | ADDRESS 

If 

D 


Byte (hex) Contents 
00-03 Record 1D: C'AREL’ 
04 ID 
e For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
¢ For vm, machine and task ID 
05 Contro! block ID index value 
06 — 07 Zero 
08 —0B PST address 
OC —OF Address of buffer being released 
10-13 Address of the caller of the abend RELSTORE routine 
14—-1F Zero 
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mvs Attention 


Entry: MVS ATT 

ViT Option: ClO 

Event: Attention 

vIT Processing Module: ISTRACCI 

Control is Returned to: ISTTSCCA Or ISTTSCLA 
Applies to: MVS 


¢ ATTI iS written when an attention interrupt occurs for a channel-attached com- 
munication controller or SNA cluster controller. 


¢ ATTL is written when an attention interrupt occurs for a channel attached 
NON-SNA device. 


¢ ATTX is written when an attention interrupt occurs for a channel-to-channel 
attachment. 


i “Bap 7 
HHH i 4H seb 


T\S CUA |NCB FLAG 
DIT ADDRESS} BYTES 
A 
T 
iL 


Byte (hex) Contents 
00-02 Record ID: C‘ATT’ 


mo< 4 


03 NCB type: | for ICNCB, L for LONCB, X for XCNCB 
04 Address space ID (or zero if address space ID is greater than X'FF') 
05 Link station state (NCBLNKST) for ICNCB and LONCB; station state 


(XCNSSFSM) for XCNCB 
06 — 08 Zero 


09—-O0B Channel device name in EBCDIC (either a CUA or device number) 
OC — OF NCB address 

10-13 Flag bytes (NCBFLAGS) 

14 Zero 

15 lO completion code in field IOSCOD in the 1osB 

16-17 Sense data in field IOSSNS of the 10SsB 

18—1F Channel status word from the 1osB 
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va vsE Asynchronous Exit 


Entry: Vid VSE AXIT 

vIT Option: PSS 

Event: Asynchronous exit 
vit Processing Module: ISTRACPS 

Control is Returned to: ISTAPCSX 

Applies to: VM, VSE 


This trace record is written whenever PSs exits to the operating system because 
there is no more work to do under a given task. 

1}1 

8) 9 


CHRCRACHACH RCH ECR ECHECHECHICHECHRCHECHECHECHECI MDG U MU M0 GUa mmm 
O}14;2;3/4/5/6)7 8/9 AI BIC DI E|FIO}14;2)3)4/5| 647 
AXIT |I PST 

D ADDRESS TPPOSTD| NORMAL | TPPOSTD | NORMAL 


Byte (hex) Contents 

00-03 Record ID: C’‘AXIT' 

04 ID 
¢ For vM, machine and task ID 
e For VSE, task ID 

05 —07 Zero 

08 — 0B PST address 

OC — OF Zero 


1{1jifafafi 
AIBIC|D\E|F 


10-13 Synchronous TPPOSTed queue (PSTSTPP) 
14-17 Synchronous normal queue (PSTSNRM) 
18—1B Asynchronous TPPOSTed queue (PSTATPP) 
1C—-1F Asynchronous normal queue (PSTANRM) 
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“Restricted Materials of IBM” CCI or CCO for RUPE 
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SSCP (RUPE — Part 1) 


Entry: CCI or CCO 

viT Option: SSCP 

Event: Requests/Responses with a RUPE 

vit Processing Module: ISTRACSC 

Control is Returned to: ISTINCCI for inbound processing, ISTINCCO for outbound 
processing 

Applies to: MVS, VM, VSE 


This trace record provides information about outbound processing, which proc- 
esses a request, and inbound processing, which sends a response to the 
requester. 


If this entry is associated with an event failure (that is, the sense data is non-zero), 
this entry is generated whether the sscp option is in effect or not. It is treated as an 
exception condition, and therefore, is traced whenever the viT is active. 


OOO;O/O/O/O;O;O;O/O;O;OO;O;Of;L LAL LiLp@p@pLilpaAjp@ylj1j1y1 
Oi1]2)3/4/5) 6/7) 8/9; ABI C/DIE; FIO; 1; 2(3)4)5)6)7 89 ABI C|DIE\F 


CCl SAVE SAVE |RETURN RUPE RUPE 
AREA ADDRESS; ORIGIN DESTINATION 
ADDRESS NETWORK {NETWORK 


ADDRESS | ADDRESS 


Byte (hex) Contents 
00-02 Record Ip: 
e C'‘ccl’ for inbound processing 
¢ C'cco’ for outbound processing 
03 Flags 
¢ 80 = response RU 
¢ 40 = sense traced 
e 00 = request RU 
04 ID 
e For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For vm, machine and task ID 
e For vse, task ID 


05 Control block 1D= X'54' 

06 — 07 Zero 

08 — 0B Save area address 

OC — OF Save area ID (bytes 4, 5, 7, and 8 of the module name if available) 
10-13 Address of the issuer of the macro (CPCALL, CPEXIT, Or CPWAIT) 
14—19 For sender, network address at origin 

AA TE For sender, network address at destination 
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CC2 for RUPE “Restricted Materials of IBM” 
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SSCP (RUPE — Part 2) 


Entry: CC2 

viIT Option: SSCP 

Event: Requests/Responses with a RUPE (Part 2) 
vit Processing Module: ISTRACSC 

Applies to: MVS, VM, VSE 


This trace record is a continuation of the Ccl or CCO (RUPE) entry. 


0/0/0/0/0/0/1 
A|B{C/DJE| FIO 


1 
] 


1} 1 


1 
2|3 


0/0}0)0 Lyijljiyjl}l 
4|5|6|7|8|9 4151617|8/9 


FIRST 24 BYTES OF RU 


Byte (hex) Contents 
00-02 Record 1D: C'cc2’ 


03 Control block iID=X'54' 
04-—1B First 24 bytes of RU 
1C—1F Sense data or zero 
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SSCP (NCSPL — Part 1) 


Entry: CCl or CCO 

VIT Option: SSCP 

Event: Requests/Responses for a NCSPL 

vIT Processing Module: ISTRACSC 

Control is Returned to: ISTINCCI for inbound processing, ISTINCCO for outbound 
processing 

Applies to: MVS, VM, VSE 


This trace record provides information about outbound processing, which proc- 
esses a request, and inbound processing, which sends a response to the 
requester. 


If this entry is associated with an event failure (that is, the sense data is non-zero), 
this entry is generated whether the sscp option is in effect or not. It is treated as an 
exception condition, and therefore, is traced whenever the viT is active. 


OO;O{O;O;O;O;O;O/O;O/O;O;OfO;O; LILA LiLpLyLilp@ylyipljdjiyly. 
lo 1}2)3/4)5)6)/7)8j9j/AIBIC DIE} FIO, 1)2)3)4)5|6)7 8 9A} B\C}DIE|F 


SAVE SAVE |RETURN |CPCB qT 
AREA ADDRESS |QOPCODE |Y 
ADDRESS P 

E 


Byte (hex) Contents 
00 — 02 Record ID: 
¢ C'ccl’ for inbound processing 
¢ C'cco’ for outbound processing 
03 Flags 
e 80 = response RU 
e 40 = sense traced 
¢ 00 = request RU 
04 ID 
e For mvs, address space 10 
(or zero if address space ID is greater than K'FF') 
e For vM, machine and task ID 
e For VSE, task !D 


CCI DESTINATION 
or NETWORK 
CCO ADDRESS 


WO @D Y-TmMN 


ST 
[ese a, 
Laas a 
Toe 


O05 Control block iD= X'60' 

06 Flags (CPCBFL) 

07 Return code (CPCBRC) 

08 —0OB Save area address 

OC — OF Save area ID (bytes 4, 5, 7, and 8 of the module name if available) 

10-13 Address of the issuer of the macro (CPCALL, CPEXIT, or CPWAIT) 

14-17 CPCB operation code (see Appendix D, “CPCB Operation Codes” on 
page 645) 

18 WTD type 

19 Zero 

1A—1F Network address at destination 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 Chapter 8. Using the VTAM Internal Trace 359 


CC2 for NCSPL “Restricted Materials of IBM" 
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SSCP (NCSPL — Part 2) 


Entry: CC2 

viT Option: SSCP 

Event: Requests/Responses for a NCSPL (Part 2) 
viT Processing Module: ISTRACSC 

Applies to: MVS, VM, VSE 


This trace record is a continuation of the CCl or CCO (NCSPL) entry. 


ie bled bb 
ts eM ol 


CC2 !Cj RDTE CPCB 
; STATE | WID 


Byte (hex) Contents 
00 —02 Record 10: C‘CC2’ 


alslelslelelalalal lel 


03 Control block ID=X'60' 
04-07 RDTE state (in control block RPRE) 
08—0OB CPCB WTD (first four bytes) 


OC —1F Zero 
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SSCP (not RUPE or NCSPL) 


Entry: CCl or CCO 

VIT Option: SSCP 

Event: Requests/Responses for neither RUPE nor NCSPL 

VIT Processing Module: ISTRACSC 

Control is Returned to: ISTINCC! for inbound processing, ISTINCCO for outbound 
processing 

Applies to: MVS, VM, VSE 


This trace record provides information about outbound processing, which proc- 
esses a request, and inbound processing, which sends a response to the 
requester. 


If this entry is associated with an event failure (that is, the sense data is non-zero), 
this entry is generated whether the sscp option is in effect or not. It is treated as an 
exception condition, and therefore, is traced whenever the viT is active. 


CHRCHRCHRCHECHECHACHRCHECHECHECHICHECH EU MDG G0 C0000 GGG Re00RGnanun 
3/4) 5/6/7) 8/9) AIBIC{DIE}FIO}1)2/3)4, 5/6) 71/8) 9/AIBICIDIEIF 


SAVE SAVE |RETURN |CPCB CPCB 
AREA ADDRESS|OPCODE |WORD 3 |WORD 4 
ADDRESS 


0;0;0 
O}1)2 
CCI 


CCO 


oO 

=> 
(aes ea 
ee 
[Sea 
sews 
ae 


Byte (hex) Contents 
00 — 02 Record 10: 

¢ C'cc!' for inbound processing 

e C'cco' for outbound processing 
03 Flags 

e Bit 0: 0 = request, 1 = response 

¢ Bit 1: 0 = nosense, 1 = sense 
04 ID 

e For mvs, address space ID 

(or zero if address space ID is greater than X'FF') 
¢ For vm, machine and task ID 
e For VSE, task ID 


05 Control block 10 (Control block 10s are shown in Appendix E, “Storage 
and Control Block ID Codes” on page 657.) 

06 CPCB flag (CPCBFL) 

07 Return code (CPCBRC) 

08 —0B Save area address 

OC — OF Save area ID (bytes 4, 5, 7 and 8 of the module name if available) 

10-13 Address of the issuer of the macro (CPCALL. CPEXIT, or CPWAIT) 

14-17 CPCB operation code (see Appendix D, “CPCB Operation Codes” on 
page 645) 

18-1B CPCB word 3 (field WTDPTR) 

1C—1F cpcs word 4 (field CPCBPH) 
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Cit or CO1 


SSCP (RUPE) 


362 VTAM Diagnosis 
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Ci1 or CO1 Trace Entries 


The following trace record provides information about the inbound and outbound 
requests sent to begin or end a same-network or cross-network LU-LU session. 


The ci and coi traces have two formats: 


¢ Format 0 is used for same-network sessions or when vTAM does not know 
whether the request is for a cross-network session. This format contains parts 
1,2, and 3 of the cin or con record, shown below. 


¢ Format 1 is used for cross-network sessions. This format contains parts 1, 2, 3, 
and 4 of the cin or con record, shown below. 


Entry: Cli and CO1 

ViIT Option: SSCP 

Event: Requests (Part 1) 

vIT Processing Module: ISTRACSC 

Control is Returned to: (Many modules possible) 
Applies to: MVS, VM, VSE 


Part 1 of the cin or con record is for both format 0 and format 1 and contains essen- 
tially the same information as the Cci or Cco entry. 


If this entry is associated with an event failure (that is, the sense data is non-zero), 
this entry is generated whether the sscp option is in effect or not. It is treated as an 
exception condition, and therefore, is traced whenever the vit is active. 


O/O;O/O;O/O;O;O;O/O;O;O;O;LiL;ApL{ljplplyi@j1j1 
3/4}5/6)7/8/9/A|BIC|DJE}F)O}1)2)3)4);5)6}718)9 


ees eae 
A\B/C\D/E|F 


CIl I I | SAVE RETURN RUPE RUPE 
or D T |AREA ADDRESS ORIGIN DESTINATION 
COl F |}ADDRESS NETWORK NETWORK 
S ADDRESS |ADDRESS 
M 
Byte (hex) Contents 
00 — 02 Record !D: 
e C'ci1' for inbound processing 
e C'co1' for outbound processing 
03 Flags 
e Bit 0: 0 = request, 1 = response 
e Bit 1: 0 = no sense, 1 = sense 
¢ Bits 6 and 7: 00 = format 0, 01 = format 1 
04 ID 
e For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e¢ For vM, machine and task ID 
¢ For VSE, task ID 
05 Control block iD = X'54' 
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06 — 07 


08 ~0B 
OC — OF 
10-13 
14-19 
1A—1F 


Cit or CO1 


Initiation and termination finite state machines (taken from the session 
information block, sis) 

Save area address 

Save area ID (bytes 4, 5, 7, and 8 of the module name if available) 
Address of the issuer of the macro (CPCALL, CPEXIT, or CPWAIT) 

Network address at origin (RUPEOAF) 

Network address at destination (RUPEDAF) 


. Usi IT 363 
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bb efenal AHP “HEE HP 
nH ali slalals 


FIR SAVE |RETURN |CPCB RUPE 
ADDRESS | OPCODE DESTINATION 
ADDRESS| ID NETWORK 
ADDRESS 


Byte (hex) Contents 
00-02 Record Ip: 
¢ C'ci1' for inbound processing 
e C’‘co1’' for outbound processing 
03 Flags 
e Bit 0: 0 = request, 1 = response 
e Bit 1: 0 = no sense, 1 = sense 
e Bits 6 and 7: 00 = format 0, 01 = format 1 
04 ID 
¢ For mvs, address space !D 
(or zero if address space 1D is greater than X'FF') 
e For vm, machine and task ID 
¢ For VSE, task ID 


SSCP (NCSPL) 


05 Control block ID = X'60' 

06 Flags (CPCBFL) 

07 CPCB return code (CPCBRC) 

08 — 0B Save area address 

0C — OF Save area !D (bytes 4, 5, 7, and 8 of the module name if available) 

10-13 Address of the issuer of the macro (CPCALL, CPEXIT, or CPWAIT) 

14-17 CPCB operation code (see Appendix D, “CPCB Operation Codes” on 
page 645) 

18 WTD type 

19 Zero 

TA— 1F Network address at destination (NCSPLDAF) 


364 VTAM Diagnosis LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


“Restricted Materials of IBM" Cit or CO1 
Licensed Materials — Property of IBM 


SSCP (not RUPE or NCSPL) 


HH 4H APP sella Ane 
dMi 4H Hb APHP Aba ae 


CIl RETURN |CPCB CPCB CPCB 
| ADDRESS|OPCODE |WORD 3 |WORD 4 


Byte (hex) Contents 
00 —02 Record !p: 
¢ C'ci1’ for inbound processing 
e C'‘co1’ for outbound processing 
03 Flags 
e Bit 0: 0 = request, 1 = response 
e Bit 1: 0 = nosense, 1 = sense 
e Bits 6 and 7: 00 = format 0, 01 = format 1 
04 ID 
e For mvs, address space !D 
(or zero if address space ID is greater than X'FF') 
e For vm, machine and task ID 
e For VSE, task IO 


05 Control block 1D (Control block ibs are shown in Appendix E, “Storage 
and Control Block ID Codes” on page 657.) 

06 cPpcs flag (CPCBFL) 

07 Return code (CPCBRC) 

08 —08 Save area address 

0C — OF Save area ID (bytes 4, 5, 7, and 8 of the module name if available) 

10-13 Address of the issuer of the macro (CPCALL, CPEXIT, or CPWAIT) 

14-17 CPCB operation code (see Appendix D, “CPCB Operation Codes” on 
page 645) 

18-1B ceca word 3 (field WTDPTR) 


10—1F cpcs word 4 (field CPCBPH) 
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Cl2 or CO2 


SSCP (RUPE) 


366 
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Entry: Cl2 or CO2 

VIT Option: SSCP 

Event: Requests (Part 2) 
viT Processing Module: ISTRACSC 

Applies to: MVS, VM, VSE 


The cl2 and co2 trace records are continuations of the cl1 and co1 entries. 


1 


1 
0 


1 


ae 


Lj 1 
2}3 


i 
4\5 


6 


0}0)0)0;0/0}0)0/0/0)0 Liljljdjlyl 
5}6)7/8)9{A|BIC|DIE|F i 


BC 


alah 


FIRST 24 BYTES OF RU 


Byte (hex) Contents 
00-02 Record 1D: 
¢ C'cl2’ for inbound processing 
e C'co2' for outbound processing 


03 Control block 10 = X'54' 
04-—1B First 24 bytes of Ru 
1C —1F Sense data or zero 
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SSCP (NCSPL) 


© 
© 


© 
Ww 


Byte (hex) 
00-02 


03 
04-07 


08 — 0B 
0C—1F 


SSCP (not RUPE or NCSPL) 


Byte (hex) 
00-02 


03 


04—-1F 


OO/O/O/O/OO/O/OO;/O;O;O;O;O; AL; TL;TpPApA;TPTyLpLyT; Apap aylya 
1}2/3/4|5)6)7/8/9|A|B/ CIDE} FiO, 1)2)3,4|5)6)7|8,9|A|Bi/C|DJE|F 
I 


C{2 |C| RDTE CPCB 
or |B{ STATE | WTD 
C02 |1 

D 


OH COHONKOMECHCCHACHECHECHACHACHOCHCRLCHICHIC] PUG PG POU GPGPGDGUGRGPGRGPGRap a 
0/11/2)3}4/5/6/7/8/9JA|BIC|DIE| FO} 1) 2) 3) 4)5)6)7;8/ 9A} ByC| Di E}F 


C12 |C 
or {|B 
Co2 |I 

D 


Ci2 or CO2 


Contents 
Record ID: 
¢ C’‘ci2’ for inbound processing 
e C‘co2' for outbound processing 
Control block ipD=X'60' 
RDTE state (in control block RPRE). This value, a resource status code, 
is explained in VTAM Messages and Codes and in control block FsM, 
which is documented in VTAM Data Areas. 
CPCB WTD (first four bytes) 
Zero 


Contents 
Record ID: 
¢ C’‘ci2’ for inbound processing 
¢ C‘co2’ for outbound processing 
Control block ID (Control block ips are shown in Appendix E, “Storage 
and Control Block ID Codes” on page 657.) 
Zero 
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SSCP (RUPE, NCSPL, or Not RUPE or NCSPL) 


368  VTAM Diagnosis 


Entry: Cl3 or CO3 

vIT Option: SSCP 

Event: Requests (Part 3) 
viT Processing Module: ISTRACSC 

Applies to: MVS, VM, VSE 


Part 3 of the cin or Con record is for both format 0 and format 1 and contains the 
address of the istsiB for the session, the ISTPCID, and the PLU and SLU names. 


Note: If this is the last Cin or con entry, these are the PLU and SLU names as known 
in this network. If this entry is followed by ci4 or co4, these are just the PLU and SLU 
names. The ci4 or co4 entry identifies the network. 
Lylilyiyijiylyl 
BIDIAIBICIDIE|F 


reed ba Lylj}ljljlylyl 
0}1)2)3 1]2}3|4|5|6}7 


= SIB PLU NAME SLU NAME 
ADDRESS 
003 


Byte (hex) Contents 
00 —02 Record Ip: 
e C’'ci3’ for inbound processing 
e C'co3' for outbound processing 


PCID FOR THIS 
REQUEST 


03 Zero 

04-07 SIB address 

08 — OF PcID for this request 
1047 PLU name 

18-—1F SLU name 
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SSCP (RUPE, NCSPL, or Not RUPE or NCSPL) 


Entry: Ci4 or CO4 

viT Option: SSCP 

Event: Requests (Part 4) 
vIT Processing Module: ISTRACSC 

Applies to: MINS, Vii, VSE 


Part 4 of the Cin or con entry is for format 1 only. 


PCID IN PLU NETID SLU NETID 
PREVIOUS 
REQUEST 


Byte (hex) Contents 
00-02 Record ID: 

e C'ci4’ for inbound processing 

e C'co4’ for outbound processing 
03 — 07 Zero 


08 — OF PCID in previous request 
10-17 PLU network ID 
18-—1F SLU network ID 
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vse SHM Connect 


Entry: vse CONN 
viT Option: ClO 

Event: Connection 
viT Processing Module: ISTRACCI 
Control is Returned to: ISTTSCIR 
Applies to: VSE 


This trace record is generated for x.21 short-hold mode attachments. It is written 


when a port is connected to a station. 
LJLJLpLpLylyLpLylylplyiylyiyiy. 
O/1)2)3)4/5/6)7/ 8/9 AI BICI DEF 


Q0/010;0)0)0)/0)0)0)0)0)0)0/0/0)0 
Q0}1)2)3)4)51/6)7/819;A| BIC DIE] F 
HALCB | PUT P 
ADDRESS | ADDRESS E 
A 


=nonsSs Vv 


CONN {T/C}PIS CUA |GROUP 
I) FiMIH NCB 
KIS|FYS ADDRESS 

MiS|I 


Byte (hex) Contents 
00-03 Record ID: C‘CONN’ 


04 Task identification key 

05 Connection finite state machine (FSM; See HALCFSM in ISTHALCB for 
values) 

06 Port manager FSM (See HALPMFSM in ISTHALCB for values) 

07 x.21 short-hold mode status indicator (see PUTFLG1 in ISTPUT) 

08 Zero 

09—0B Channel unit address of sink 

OC —OF Group network control block address (ISTGRPCB) 

10-13 Link network control block address (ISTHALCB) 

14-17 Physical unit table address (iSTPUT) 

18-—1B Zero 

10 —-1D PU element ADD 


1E—1F Zero 
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CPPURGE or CPPOST with EID or URC (Part 1, for V3R1, V3R1.1, and V3R1.2) 


Entry: CPPG or CPPT 

viIT Option: SSCP 

Event: CPPURGE Or CPPOST Macro (Part 1) 

ViIT Processing Module: ISTRACSC 

Control is Returned to: ISTCPCPP 

Applies to: MVS (V3R1.1 and V3R1.2), VM (V3R1.1 and V3R1.2), VSE 


(V3R1 and V3R1.2) 


This trace record gives information about CPPURGE or CPPOST macroinstruction proc- 
essing. It may help you determine why 1/o is outstanding or why an sscp request is 
failing. 


CPPG and CPPT are the complements of cpwT. Each CPPT is preceded by a cPwT. But 
a CPPG Can post several events at once, as it may be concluding several CPWT 


entries. 
L}Li1} lil} 1})1y1}1}1)1 
SI6I71BI9OIAIBIC|DIEIF 


0/0;0/0;0;0/0;0/0/0;0/0;0 
0)1)2)3/4/5)6)7/8)9{A|B 
L FIRST 12 BYTES OF EID 


9 
CPPG {I 0}LQAB DATA 
D - | ADDRESS or URC 


Byte (hex) Contents 
00-03 Record ID: 
e C'cppPG' for CPPURGE processing 
e C'cppT’ for CPPOST processing 
04 ID 
e For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For vm, machine and task ID 
¢ For VSE, task ID 


RETURN 
ADDRESS 


mooOM 
mo< 4 


— ™m rr 


05 Return code set by CPPOST or CPPURGE 
06 Type byte: 

e X'0O' = URC was used for this macro 

e X'01' = Event ID (EID) was used for this macro 
07 If type = X'00' (URC), zero. 


If type=X' 01° (EID), length of eventiD. (Wait state event Ips are 
explained in VTAM Messages and Codes.) 


08—0OB Address of LQAB for this macro 

OC — OF For MVS and vSsE, data operand specified by this macro. 
For VM, WREDTA IN WRE 

10-13 Address of issuer of CPPURGE or CPPOST macro 


14—1F Type information: 
If type = X‘00' (URC), URC up to 12 bytes 
If type = X'01' (EID), EID up to 12 bytes. (Wait state event IDs are 
explained in VTAM Messages and Codes.) 
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CPPURGE or CPPOST (Part 2, for V3R1, V3R1.1, and V3R1.2) 


Entry: CPP2 

VIT Option: SSCP 

Event: CPPURGE or CPPOST Macro (Part 2) 

vit Processing Module: ISTRACSC 

Applies to: MVS (V3R1.1 and V3R1.2), vm (V3R1.1 and V3R1.2), vse 


(V3R1 and V3R1.2) 


This trace record contains the rest of the event ID for CPPURGE or CPPOST macroin- 
struction processing. 


O;,O/O/O;O;OO;O;O;O;O;LIL LLL Ly@s1plplydyadjijij.qyi 
5/6) 7/8/9|A/BIC]DIE|F/O;1,2)314/5)6)7/ 8/9} AIBIC|DIE|F 


ADDITIONAL EVENT IDENTIFIER FOR CPPOST/CPPURGE 
(if needed) 


0}0 
QO; 1)2}3/4 


Byte (hex) Contents 
00-03 Record 1D: C'cpp2’ 
04—1F Event ID (up to 28 bytes) 
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CPPURGE or CPPOST for PVI or Non-PVI Event (Part 1, for V3R2) 


Entry: CPPG or CPPT 

VIT Option: SSCP 

Event: CPPURGE or CPPOST Macro (Part 1) 
VIT Processing Module: ISTRACSC 

Control is Returned to: ISTCPCPP 

Applies to: MVS (V3R2), VM (V3R2), VSE (V3R2) 


This trace record gives information about CPPURGE or CPPOST macroinstruction proc- 
essing. It may help you determine why 1/o is outstanding or why ansscp request is 
failing. 


CPPG and CPPT are the complements of Ccpwt. Each CPPT is preceded by a cpwr. But 
a CPPG can post several events at once, as it may be concluding several CPWT 
entries. 


OO/O;OO;O;O;O/O;OlO/O;O;O;O;O;LALILTILilyLpLpdylyly@ylydyi1jiyi 
O}1LI2;3)4) 51/6) 7/8 /9JAIBIC|DIE;FI/O}1)2) 3/4) 5/6)7)8/9/AIBICIDIE]F 


CPPG |I|C/T}O}LQAB WREDATA| WORK OPC IN |SAVE SENSE 
D}Q|}Y}P}ADDRESS|IN WRE | ELEMENT | WORK AREA ID| DATA 
DP ADDRESS| ELEMENT jor 0 
ETE 


Byte (hex) Contents 
00-03 Record ID: 
e C'‘cppG’ for CPPURGE processing 
¢ C'cPPT for CPPOST processing 
04 ID 
¢ For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For vM, machine and task ID 
e For vse, task ID 
05 Return code set by CPPOST or CPPURGE 
06 Type flags 
¢ B'00000000’ = URC, non-PvI event 
e B'‘00000001' = URC, Pvi event 
e B‘00000010' =EID, non-Pvi event 
¢ B'00000011'=EID. Pvi event 
07 Optional field 
¢ ForcppaG: Zero 
¢ For CPPT MVS/370 VSE: Zero 
e For CPPT MVS/XA VM: O for FIND, 1 for Da, 2 for POST 


08— OB LOAB address 

OC — OF Data field in ISTWRE 

10-13 Work element address 

14-17 CPCB operation code that indicates the original request for this work 


element or zero. CPCB operation codes are shown in 
Appendix D, “CPCB Operation Codes” on page 645. 


18-—1B For pvt events, caller’s save area ID or 0 
For non- Pv! events, save area ID 
1C-—1F Sense data or zero 
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CPPURGE or CPPOST (Part 2, for V3R2) 


374 TAM Diagnosis 


Entry: CPP2 

viT Option: SSCP 

Event: CPPURGE or CPPOST Macro (Part 2) 
vit Processing Module: ISTRACSC 

Applies to: MVS (V3R2), VM (V3R2), VSE (V3R2) 


This trace record is a continuation of the CPPG or CPPT (v3R2) trace record. 


Byte (hex) 
00-03 
04-07 
08 — 18 
19 1F 


Contents 

Record ID: C‘'CPP2’ 

Return address to issuer of the CPPURGE or CPPOST macroinstruction 
RUPEURC or 0 

Zero 
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CPPURGE or CPPOST (Part 3, for V3R2) 


Entry: CPP3 

viT Option: SSCP 

Event: CPPURGE or CPPOST Macro (Part 3) 
viT Processing Module: ISTRACSC 

Applies to: MVS (V3R2), VM (V3R2), VSE (V3R2) 


This trace record contains part or all of the event !D (EID) for CPPURGE or CPPOST 
macroinstruction processing. If an EID is less than 24 bytes long, only the bytes in 
the actual EID will be moved to the corresponding fields in the trace records. The 
leftover bytes will be set to zero. 


Note: This trace record is produced only when the wWRe points to an EID. 


OOO O/O/O;O/O/O;O/O;O;O;O;O;O;LpLpLpLpPLILiLilplLydydylfiyly iy. 
O}1)2)3)4]5,6/7/8/9)A; BIC |DIE}F)O}14;2)3)4)5}6)7);8/9 A; BIC DIE} F 


CPP3 7 FIRST 24 BYTES OF EID 


Byte (hex) Contents 

00-03 Record 10: C'CPP3’ 
04-06 Zero 

07 Length of E!D 
08—1F First 24 bytes of EID 
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CPPURGE or CPPOST (Part 4, for V3R2) 


376 > VTAM Diagnosis 


Entry: CPP4 

VIT Option: SSCP 

Event: CPPURGE or CPPOST Macro (Part 4) 
viT Processing Module: ISTRACSC 

Applies to: MVS (V3R2), VM (V3R2), VSE (V3R2) 


This trace record contains part or all of the RU for CPPURGE or CPPOST macroin- 
struction processing. It may help you determine why 1!/O is outstanding or why an 
sscp request is failing. If an RU is less than 24 bytes long, only the bytes in the 
actual Ru will be moved to the corresponding fields in the trace records. The left- 
over bytes will be set to zero. 


Note: This trace record is produced only for pvi events where a RUPE is available. 
O/afolojolojojojolololofojajafafafafafafajafafafrya 
OV1LI2Z213/415/6}7/8)9 AI BICID/ EJ FIO; 1) 2/314) 5) 6/7 /8/9;A/BIC|DIE;F 


CPP4 FIRST 24 BYTES OF RU or 0 po 


Byte (hex) Contents 

00-03 Record 1D: C'CPP4' 
04-—1B First 24 bytes of RU 
1C—1F Zero 
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CPRC (Part 1) 


Entry: CPRC 

viIT Option: SSCP 

Event: CPRC Macro (Part 1) 

viIT Processing Module: ISTRACSC 

Control is Returned to: The module that issued the cPRC macro (many pos- 
sible) 

Applies to: MVS.VM, VSE 


This trace record gives information about CPRC macroinstruction processing. It is 
written when a VTAM module isSues a CPRC macroinstruction to set a non-zero 
sense code in an RUPE. 


This event is treated as an exception condition and is always traced, whether the 


SSCP option is in effect or not. 
1 sD 
Al516/7\8/9)A\BICIDI EF 


O;O/O/O;O;O;O;O/O;O;O;O;O;O;O;O;1{ 1) 141 
O}1)2)3)4)5,6|7/8/9/A| Bi CIDE] F/O} 1) 2)3 


SENSE RUPE RUPE 
ADDRESS] THIS ORIGIN DESTINATION 
NETWORK |NETWORK 


ADDRESS {ADDRESS 


Byte (hex) Contents 
00-03 Record 10: C‘CPRC’ 
04 ID 
¢ For mvs, address space !D 
(or zero if address space ID is greater than X'FF') 
¢ For VM, machine and task ID 
* For VSE, task ID 
05—07 Zero 


08—OB Address of RUPE for this macro, or 0 

OC —OF CPCB operation code for RuPE that indicates the original request for this 
RUPE 

10-13 Sense code 

14-19 Network address at origin 

1A—1F Network address at destination 
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CPRC (Part 2) 


Entry: CPR2 

VIT Option: SSCP 

Event: CPRC Macro (Part 2) 
viT Processing Module: ISTRACSC 

Applies to: MVS, VM, VSE 


This trace record is a continuation of the CPRC entry. 


tHE ot pa db bb ob BF 
PM B/C|DJE 


Byte (hex) Contents 

00-03 Record 1D: C'CPR2’ 

04-07 Address of the issuer of the CPRC macro 
08—18 RUPEURC 

19-—1F Zero 


RETURN 
ADDRESS 
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CPWAIT (Part 1, for V3R1, V3R1.1, and V3R1.2) 


Entry: CPWT 

ViT Option: SSCP 

Event: CPWAIT Macro (Part 1) 

vit Processing Module: ISTRACSC 

Control is Returned to: ISTCPCPW 

Applies to: mvs (V3R1.1 and V3R1.2), vm (V3R1.1 and V3R1.2), vse 


(V3R1 and V3R1.2) 


This trace record gives information about CpwalT macroinstruction processing. It 
may help you determine why I/O is outstanding or why ansscp request is failing. 


This entry is eventually followed by a CPPT entry (to resume processing) or a CPPG 
entry (to purge the waiting task). Use the EID field to match corresponding entries. 


O/O;O/O/O/O;O;O;O;O;O/O;O;O;O;Of;L AT; Lydylj.yl 
O71)2)3/4)5/6; 7/8) 9|A|BIC| DIE} F/O} 1)2)3) 4) 5] 647 


CPWT |] E} LQAB WREDATA| WORK FIRST 8 BYTES 
D I|}ADDRESS|IN WRE | ELEMENT | WORK 
ADDRESS | ELEMENT 


OF CPCBURC 

Byte (hex) Contents 
00-03 Record 1p: C'CPWT' 
04 ID 

e For mvs, address space I0 

(or zero if address space ID is greater than X'FF') 

¢ For VM, machine and task ID 

¢ For VSE, task ID 
05-06 Zero 


1 
8 


] 
9 


1 
A 


1 
B 


1 
C 


] 
D 


1 
E 


=, fo 


07 Length of event ID 

08 -—0B Address of LQaB for this CPWAIT macro 

OC — OF Data field in ISTWRE when CPWAIT is performed 
10-13 Work element address: 


Zero for asynchronous CPWAIT 
Non-zero for synchronous CPWAIT 
14-17 CPCB operation code that indicates the original request for this work 
element (cPcB operation codes are shown in Appendix D, “CPCB 
Operation Codes” on page 645.) 
IS =1F CPCBURC (first 8 bytes) 
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CPWAIT (Part 2, for V3R1, V3R1.1, and V3R1.2) 


380  VTAM Diagnosis 


Entry: CPW2 

VIT Option: SSCP 

Event: CPWAIT Macro (Part 2) 

VIT Processing Module: ISTRACSC 

Applies to: MVS (V3R1.1 and V3R1.2), vM(V3R1.1 and V3R1.2), VSE 


(V3R1 and V3R1.2) 


This trace record is a continuation of the CPWAIT trace record. 


O/O/O{O/O/O/O/OO/O;OO;O/O/O/O; Li TL; A;ApL{LPLpLilpljayaypajdyl 
O}1)2)/31/4)5/6]7/8/9 AI BIC/DIEJF/O}1)2)3}4)5)6)7(8/9)A| Bi CDI E|F 
CPW2 jRETURN FIRST 24 BYTES OF EID 

ADDRESS 


Byte (hex) Contents 
00-03 Record 1D: C'cpwa’' 


04-07 Address of issuer of CPWAIT macro 
08—1F Event ID (up to 24 bytes). See VTAM Messages and Codes for a list of 
EIDS. 
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CPWAIT for PVI or Non-PVI Events (Part 1, for V3R2) 


Entry: CPWT 

ViT Option: SSCP 

Event: CPWAIT Macro (Part 1) 

VIT Processing Module: ISTRACSC 

Control is Returned to: ISTCPCPW 

Applies to: mvs (V3R2), vm (V3R2), vse (V3R2) 


This trace record gives information about CPWAIT macroinstruction processing. It 
may help you determine why I/O is outstanding or why an sscp request is failing. 


This entry is eventually followed by a cpPT entry (to resume processing) or a CPPG 
entry (to purge the waiting task). Use the Elp field to match corresponding entries. 


be nee “Mia WBA ABAE ARE 
Heb Aik HP ABE siHals or 


LQAB WREDATA | WORK OPC IN |SAVE 
ADDRESS|IN WRE {ELEMENT | WORK 
ADDRESS} ELEMENT jor 0 


Byte (hex) Contents 

00 — 03 Record ID: C'CPWT’ 

04 ID 
¢ For Mvs, address space !D 

(or zero if address space ID is greater than X'FF') 

e For VM, machine and task ID 
¢ For VSE, task ID 

05 Zero 

06 Type flags 
e B'00000001'=Pvi event 
¢ B'00000000' = non-Pv! event 


07 Zero 

08—-OB LQAB address for this CPWAIT macro 

OC —OF Data field in ISTWRE when CPwaAIiT is performed 

10-13 Work element address 

14-17 CPCB operation code that indicates the original request for this work 


element or zero (CPCB operation codes are shown in 
Appendix D, “CPCB Operation Codes’ on page 645.) 
18-—1B For pvi event, caller’s save area ID or zero 
For non- Pvi event, Save area ID 
1C—1F Zero 
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CPWAIT (Part 2, for V3R2) 


Entry: CPW2 

VIT Option: SSCP 

Event: CPWAIT Macro (Part 2) 

ViIT Processing Module: ISTRACSC 

Applies to: mvs (V3R2), vm (V3R2), vse (V3R2) 


This trace record is a continuation of the CPWaIT trace record. 
CRRCHECHRCRACHECHRCRECHECHECRECHECHECHECHECHICING DOU UG Damm mmn| 
O/LIZ213/4)/5/6)7 18/9 AIBICIDIE|FIO/1}213)4)5]/6]7 
CPW2 RETURN RUPEURC or 0 

ADDRESS 


Byte (hex) Contents 

00-03 Record ID: C‘cPw2’ 

04-07 Return address to issuer of the CPWAIT macroinstruction 
08 — 18 RUPEURC or 0 

19—-1F Zero 
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CPWAIT (Part 3, for V3R2) 


Entry: CPW3 

ViT Option: SSCP 

Event: CPWAIT Macro (Part 3) 

vVIT Processing Module: ISTRACSC 

Applies to: MVS (V3R2), VM (V3R2), VSE (V3R2) 


This trace record is a continuation of the cpw2 trace record. If an EID is less than 24 
bytes long, only the bytes in the actual EID will be moved to the corresponding 
fields in the trace records. The leftover bytes will be set to zero. 


Note: This trace record is produced only when the wre points to an EID event. 


OO;O;O;O;O;O/O/O;OjO;O;O;O;O;O;DTi AAPL LpLpLpL{LpTyayljiydyayl 
O11}2/3/4)5])6)7/8/9}A/BIC|DJE}F/O}1)2}3}4)5)6]7)/8)9}A}B/C}|DIE]F 


FIRST 24 BYTES OF EID 


Byte (hex) Contents 

00-03 Record 1D: C‘'CPW3’ 
04-06 Zero 

07 Length of EID 

08 — 1F First 24 bytes of EID 
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CPWAIT (Part 4, for V3R2) 


384 VTAM Diagnosis 


Entry: CPW4 

vit Option: SSCP 

Event: CPWAIT Macro (Part 4) 

vit Processing Module: ISTRACSC 

Applies to: MVS (V3R2), vm (V3R2), vSE (V3R2) 


This trace record is a continuation of the Cpw3 trace record. If an RU is less than 24 
bytes long, only the bytes in the actual Ru will be moved to the corresponding fields 
in the trace records. The leftover bytes will be set to zero. 


Note: This trace record is produced only for pvi events where a RUPE is available. 


OO;O;O;O/O;O;O;O;O;O;O;O; LT Li A{LyLyLpPLplLy@p{Tyifljiyiyjlyl 
3/4)5/6)7|8{/9/A/BiCIDIE;FIO}1)2)3)4) 5] 6) 7; 8{9/AlB/C|DIE|F 


CPW4 FIRST 24 BYTES OF RU or 0 


Byte (hex) Contents 

00-03 Record 1D: C'cPw4’ 
04-—1B First 24 bytes of RU 
1C=1F Zero 
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vse SHM Disconnect 


Entry: vse DISC 

VIT Option: ClO 

Event: Disconnection 
viT Processing Module: ISTRACCI 
Control is Returned to: ISTTSCVI 
Applies to: VSE 


This trace record is generated for x.21 short-hold mode attachments. It is written 
when a port is disconnected from a station. 


OO;/O/O;O/O;O;O;O/O;O/O/O;O;O;O; DT] A;PAPLIL Lyall dpaylp i} ijayl 
O}1L]2)3/4)5/6)7/8/9{ALBICIDJE;FIO} 1} 2) 3) 4) 5/6)7) 8/9) A)BiC}DJE}F 


DISC. VTyCVPIS CUA |GROUP |HALCB- | PUT 
T}F\M|H NCB ADDRESS | ADDRESS 
K|S|FIS ADDRESS 

MiS{I 


Byte (hex) Contents 
00 —03 Record 1D: C'DISC’ 


=nn=z= Vv 


04 Task identification key 

05 Connection finite state machine (FSM; See HALCFSM in ISTHALCB for 
values) 

06 Port manager FSM (See HALPMFSM in ISTHALCB for values) 

07 x.21 short-hold mode status indicator (See PUTFLG1 in ISTPUT) 

08 Zero 

09—0B Channel unit address of link 

OC — OF Group network control block address (ISTGRPCB) 

10-13 Link network control block address (iSTHALCB) 

14-17 Physical unit table address (ISTPUT) 


18—1F zero 
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PAB Dispatch (Part 1, for V3R1, V3R1.1, and V3R1.2) 


386 VTAM Diagnosis 


Entry: DISP 

vIT Option: PSS 

Event: PAB Dispatch (Part 1) 

viT Processing Module: ISTRACPS 

Control is Returned to: ISTAPCPD 

Applies to: MVS (V3R1.1 and V3R1.2), ¥M (V3R1.1 and V3R1.2), VSE 


(V3R1 and V3R1.2) 


The oisp entry marks the beginning of a PAB diSpatch, which is VTAM’s major “unit of 
work.” This unit exists until terminated by an ExiT entry. While processing, it may 
wait for other events to complete (WAIT). It resumes processing with a RESM entry. 
The unit may be interrupted by a higher priority task and continue when that task is 
finished. 


To correlate aJl events associated with this unit, look for the RPH address, which is 
in many trace records, and match it to the RPH address in the Disp trace record. 
This unit has exclusive use of that RPH until EXIT. 


O/O/O;O/O;O/O;O/O;O;O/O/O;O;/O/O; LI LL LiLplylylp{lydylyi{tyiyayl 
O}1/2)3/4/5/6}7/8/9)A;BIC|DIE}F{ 0) 1]2)3)4)5)6)7)8)9;A|BiC|DIE|F 


DISP {I/C} P | PST PAB MODULE |RPH 
DiB| A |ADDRESS|ADDRESS|ELEMENT;CHAIN |NAME ADDRESS 
I or DVT 
D ADDRESS 


Byte (hex) Contents 
00 — 03 Record ID: C'pDISP’ 
04 ID 

e For MvS, address space ID 

(or zero if address space Ip is greater than X'FF') 

¢ For VM, machine and task ID 

e¢ For VSE, task ID 
05 Control block ID of work element (Control! block Ips are shown in 

Appendix E, “Storage and Control Block ID Codes” on page 657.) 

06 —07 PAB Offset 
08—OB PST address 
OC —OF PAB address 


1 © WW 


10-13 Address of work element currently being dispatched 

14-17 PAB Chain field 

18-1B Module name abbreviation (bytes 4, 5, 7, and 8 of the name of the first 
module to get control), or PAB DvT address (high order bit of X'18' = 0) 

1C—1F RPH address. The RPH address in location 1C — 1F appears in many 


other viT entries associated with this particular dispatch. Use this RPH 
address to group events associated with this dispatch. The RPH is 
freed or reused after an ExiT trace record. 
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PAB Dispatch (Part 2, for V3R1, V3R1.1, and V3R1.2) 


Entry: DIS2 

VIT Option: PSS 

Event: PAB Dispatch (Part 2) 

viT Processing Module: ISTRACPS 

Applies to: mvs (V3R1.1 and V3R1.2), vw (V3R1.1 and V3R1.2), vse 


(V3R1 and V3R1.2) 


This trace record is a continuation of PAB Dispatch (Part 1). 


sll alleBlslebebbllle 


0}0/0/0}0/0;0)0 
0/1)2}3)4}5)6)7 


DIS2 |WORK PAB EXTENSION or 0 
ELEMENT 
ADDRESS : 
or 0 


Byte (hex) Contents 

00-03 Record 1D: C'pls2’ 

04-07 Address of work element, or zero. Zero means either that there was 
no work element, or that this process queues work elements some- 
where other than the PAB. 


08 Flag field (PABFLAGS) 
09 — OF Zero 
10—1F PAB extension (PABXTNSN) if this is an extended PAB. 
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PAB Dispatch (V3R2) 


Entry: DISP 

viT Option: PSS 

Event: PAB Dispatch 

viT Processing Module: ISTRACPS 

Control is Returned to: ISTAPCPD 

Applies to: MVS (V3R2), vM(V3R2), vse (V3R2) 


Each PaB is identified by a unique index number. vTAM uses this number to find the 
called. module and then creates a vit entry for it. 


The pisP entry marks the beginning of a PAB dispatch, which is VTAM’s major “unit of 
work.” This unit exists until terminated by an ExiT entry. While processing, it may 
wait for other events to complete (wait). It resumes processing with a RESM entry. 
The unit may be interrupted by a higher priority task and continue when that task is 
finished. 


To correlate all events associated with this unit, look for the RPH address, which is 
in many trace records, and match it to the RPH address in the bisP trace record. 
This unit has exclusive use of that RPH until EXIT. 


OO;O/O/O/O/O/O;O;O;O/O;O/O;O;O; A; AL LJLILiLilpapaylplplyiiidyi 
O71, 2)3)4)5)6)7/8/9|AIBICIDIE}F IO} 14 2}3)4)5)6}7 1/8) 9} A} Bi C|D EF 


DISP |IjC}F)O}PST PAB CURRENT |}MODULE |RPH 
D|B|L|- {ADDRESS | ADDRESS | WORK ADDRESS 
TlA ELEMENT} ELEMENT)or DVT 
D|G ADDRESS | ADDRESS | ADDRESS 


Byte (hex) Contents 
00-03 Record ID: C‘pIsP’ 
04 ID 
e For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For vM, machine and task ID 
¢ For VSE, task ID 


om = 


05 Control block ID of work element (Control block IDs are shown in 
Appendix E, “Storage and Control Block ID Codes” on page 657.) 

06 Flag field (PABFLAGS) 

07 Zero, Or PAB work element queue level dispatched for vARY extended 
PABS 


08 — 0B PST address 
OC — OF PAB address 


10-13 Address of work element most recently queued to the PAB 

14-17 Address of work element currently being dispatched 

18-—1B Module name abbreviation (bytes 4, 5, 7, and 8 of the name of the first 
module to get control), or PAB DvT address (high order bit of X'18' = Q) 

1C—1F RPH address. The RPH address in location 10 — 1F appears in many 


other vit entries associated with this particular dispatch. Use this RPH 
address to group events associated with this dispatch. The RPH is 
freed or reused after an ExIT trace record. 
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Discarded PIU Buffer (Part 1) 


Entry: DSCD 

vit Option: PIU 

Event: Discarded piu buffer (Part 1) 
vit Processing Module: ISTRACOT 

Control! is Returned to: ISTTSCUD 

Applies to: VSE (V3R2), MVS, VM 


This trace record is written when VTAM’s TSC utility discard routine, ISTTSCUD, dis- 
poses of piu buffers because of an error condition. The reason code and module 
identifier can be used to explain the reason for the discard. This entry is treated as 
an exception condition and is always traced, regardless of the viT options specified, 
if the vit is active. 


] 


7 “hs ale Q0}0)0)0}1 
a sb Hb CIDE; FJO}1 
DSCD {1 }REASN| TSCB 20 BYTES OF PIU 
D)CODE |ADDRESS 


Byte (hex) Contents 
00-03 Record 1D: C'DSCD’ 
04 ID 

e For Mvs, address space 1D 

(or zero if address space ID is greater than X'FF') 

e For vm, machine and task ID 

¢ For vse, task !D 
05-07 Discard reason code in hex. (piu discard reason codes are explained 

in Appendix F, “PIU Discard Reason Codes” on page 661.) 

08 — 0B Address of TSCB 
OC—1F First 20 characters of the Plu. 


alalalstellelalellol 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 Chapter 8. Using the VTAM Internal Trace 389 


DSC2 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Discarded PIU Buffer (Part 2) 


390 = VTAM Diagnosis 


Entry: DSC2 

ViT Option: PIU 

Event: Discarded piu buffer (Part 2) 
vIT Processing Module: ISTRACOT 

Applies to: vse (V3R2), mvs vm 


This trace record is a continuation of the DSCD entry. 
CHRORECHECHRCHECHECHECHECHECHECE GU GU GRU GU RRGRGMGm mm 
SIG|7IBI9IAIBICIDIEJFIO{1)2)3)4)5)6)7/8191A 


24 MORE CHARACTERS OF THE PIU 


0/0 


1} 1 
213\4 


B x Pa 


MODULE 
ID 


Byte (hex) Contents 

00-03 Record ID: C‘DSsca2’ 

04-—1B 24 more characters of the Piu 

1C—1F ID of the module that is discarding the Piu 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


“Restricted Materials of IBM” 


mvs ERP 


Licensed Materials — Property of IBM 


mvs Error Recovery Procedures 


Entry: mvs ERP 

VIT Option: ClO 

Event: Error Recovery 

ViT Processing Module: ISTRACCI 

Control is Returned to: ISTZBMOJ for LDNCB, Or ISTZBMOK for ICNCB 
Applies to: MVS 

This trace record is written during error recovery for channel 1/o. 


0/0/0)0 
Q0}1)2/3 


ERP] CUA |NCB FLAG |FIC} S CSW 
or ADDRESS| BYTES : : E 
ERPL A N 

T S 

E E 


ERP! is generated for communication controllers and local SNA cluster control- 
lers. 


ERPL iS generated for local non-SNA cluster controllers. 


oelols Mee AE ane Ae 
ee 4H Hp Hee a se HA 


Lyljlj}lyijlyayl 
B|9|AIBIC|DIE}F 


Byte (hex) Contents 


00 — 


03 Record ID: 
C'ERP!' for ICNCB 
C'ERPL’ for LDNCB 


04 Address space ID (or zero if address space ID is greater than X'FF') 
05 Link station state (See NCBLNKST) 
06 — 08 Zero 
09 -0B Channel device name in EBCDIC (either a CUA or device number) 
OC — OF NCB address 
10-13 Flag bytes (NCBFLAGS) 
14 Flag byte as follows: 

Bit Meaning 

are ee Exception condition occurred (IOSEx flag is on) 

aed a aes Error routine is in control (lOSERR flag is on) 

15 0 completion code: 10SCOD 
16-17 Sense data in lIOSSNS 
18—1F Channel status word from \osB 
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vm Error Recovery Procedures (Part 1) 


Entry: VM ERP 

VIT Option: ClO 

Event: Error Recovery (Part 1) 
vIT Processing Module: ISTRACCI 

Control is Returned to: ISTTSCZZ 

Applies to: VM 


This trace record is written during error recovery for channel i/o. 


¢ ERPB is generated for error recoveries at the channel interface for a BSC line 
attached to the communication adapter. 


¢ ERPH is generated for error recoveries at the channel interface for an SDLC line 
attached to the communication adapter. 


* €RPI iS generated for communication controllers and local SNA cluster control- 
lers. 


° RPL is generated for local non-SNA cluster controllers. 


* ERPX is generated for channel-to-channel-attached hosts. 


Q 


0/0)0/0/0/0/0)0/0;0)0/0 
Q}1)2/3/4)5|6}7/8/9{A\BIC 
E 


1) id 
Q}1]2 
RPB {I CUA |NCB 
D ADDRESS 
ERPH 


CUA |NCB 
ADDRESS 


= MA 7 TT 


I 
D 


NCB 
ADDRESS 


ERPI 


CO 
ANAK 2 


NCB 
ADDRESS 


San A 2 
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Byte (hex) Contents 

00-03 Record ID: 
C‘eRPB’ for BSCLB 
C'ERPH’ for HALCB 
C'eERPI' for ICNCB 
C'ERPL’ for LONCB 
C'ERPX’ for XCNCB 


04 Machine and task 10 

05 Link finite state machine (LFSM) or link station state (see NCBLNKST) 
06 —08 Zero 

09—0B Channel device name in escoic (either a CUA or device number) 
0C — OF NCB address 

10—13 Flag bytes (NCBFLAGS) 

14 Error code (ERCOD) in NCB or zero 

15 Return code or zero 

16—17 NCB sense data in NCBSENSE or zero 

18—1F Channel status word from ncB 
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vm ERP2 


vm Error Recovery Procedures (Part 2) 
Entry: 
viT Option: 
Event: 
vit Processing Module: 
Applies to: 


“Restricted Materials of IBM” 
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vm ERP2 

ClO 

Error Recovery (Part 2) 
ISTRACCI 

VM 


This trace record is written during error recovery for channel i/o. It is a continua- 
tion of the ERPB or ERPH trace entry. 


0/0/0/0/0/0/0;0 
Q}1)2)3)4|5|6}7 


Byte (hex) Contents 


ERP2 po DEVICE-DEPENDENT INFORMATION ZZ 


Device-dependent information shown below 


00-03 Record 1D: C'ERP2’ 
04-07 Zero 

08—-1C 

1D=1F Zero 


For SDLc links (NCBTYPE = 09): 


08 Link error retry limit 

09 Error retry count 

OA Connection finite state machine 
0B Retry operation code 

OC — OF ccw address 

10 Sense byte 1 

11-12 NCB sense data area 

13-10 Zero 


For BSC links (NCBTYPE =0A): 


08 — 0B Zero 

17=— 12 Sense data from NCBSENSE 
13 Error code (NCBERCOD) 
14-1C Zero 
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vse Error Recovery Procedures (Part 1) 


VSE ERP 


Entry: VSE ERP 

viT Option: ClO 

Event: Error Recovery (Part 1) 
viT Processing Module: ISTRACCI 

Control is Returned to: SSABERV1 

Applies to: VSE 


This trace record is written during error recovery for channel 1/o. 


¢ €RPB is generated for error recoveries at the channel interface for a BSC line 
attached to the communication adapter. 


¢ ERPH is generated for error recoveries at the channel interface for an SDLC line 
attached to the communication adapter. 


* ERP! iS generated for communication controllers and local SNA cluster control- 


lers. 


e ERPL is generated for local non-SNA cluster controllers. 


aN A a2 ro 
AO Yr wm 


ANAK =2a TT 
AO Yr wm 
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0/0}0/0)0}0 | : 0 ; 4 O;O/O;O;O;1j1ydjlj1 
0}1)2/3)4)5/6 “H 7 ? C}/DJE|F}O;1)2)3)4 


CUA |NCB 


CUA |NCB 


CUA |NCB FLAG 
ADDRESS| BYTES 


FLAG 


ADDRESS| BYTES 


NCB FLAG 
ADDRESS} BYTES 


FLAG 
BYTES 


CSW 
ADDRESS 


0Uu ON DW m 
moo mM w 
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Byte (hex) Contents 

00 —03 Record ID: 
C‘ERPB’ for BSCLB 
C‘ERPH’ for HALCB 
C‘ERP!' for ICNCB 
C‘ERPL’ for LONCB 


04 Task ID 

05 Link finite state machine (LFSMm) or link station state (see NCBLNKST) 
06 Error action (ERACT) or zero 

07 —08 Zero 

09 —0OB Channel device name in Escpic (either a CUA or device number) . 


0C — OF NCB address 
10-13 Flag bytes (NCBFLAGS) 


14 Error code (ERCOD) in NCB or zero 
15 Return code or zero 

16-17 NCB sense data in NCBSENSE or zero 
18—-—1F Channel status word from NcB 
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vse Error Recovery Procedures (Part 2) 


Entry: vse ERP2 

VIT Option: ClO 

Event: Error Recovery (Part 2) 
vit Processing Module: ISTRACCI 

Applies to: VSE 


This trace record is written during error recovery for channel i/o. It is a continua- 
tion of the ERPB or ERPH trace entry. 


Olojoljojojolololajejojojojojolofafafajajafafafafafafafajafasafa 
alzlzlalalsielzialolalsiclolelrlelzlzis|alsiel7islolalsiclolele 
ERP2 po DEVICE-DEPENDENT INFORMATION po 


Byte (hex) Contents 

00-03 Record 1D: C'ERP2’ 

04-07 Zero 

08—1C Device-dependent information shown below 
1D—1F Zero 


For SDLC links (NCBTYPE =09): 


08 Link error retry limit 

09 Error retry count 

OA Connection finite state machine 
OB Retry operation code 

OC — OF Ccw address 

10 sense byte 1 

ase NCB sense data area 


13-—-1C Zero 


For BSc links (NCBTYPE =0A): 


08 —0B Zero 

11-12 Sense data from NCBSENSE 
13 Error code (NCBERCOD) 
14-—1C Zero 
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vm vSE CIO Error Recovery (V3R1.2 and Later) 


Entry: VM VSE ERP 

VIT Option: ClO 

Event: Start 1/0 

viT Processing Module: ISTRACTR (SNAP trace recording routine) 
Control is Returned to: ISTAPCES 

Applies to: VM VSE (V3R1.2 and later) 


This trace record provides error recovery information for an X.25 port. An ERP entry 
is built on every entry to ERP for an x.25 port, whether for an error or for counter 
overflow or shutdown recording. 


The telecommunications subsystem or communication adapter uses two channel 
programs: acontrol link channel program and a buffer pool channel program. 


HHH a pee alates ce 
oie ae JHE alice SIDIAIBICIDIE\F 


ERP |T|I} CUA NCB |VIRTUAL| FLAG 
Y|D ADDR |CAW BYTES 
P 
E 


Byte (hex) Contents 
00-02 Record 1D: C’ERPA’ 


0 O77 DAM 
moe2zZz mM 


03 Type: 
OC = Control link channel program 
OD = Buffer pool channel program 
04 Machine and task ID 
05 — 07 Channel device name in EBcDic (either a CUA or device number) 
08 Zero 


09-—0B NCB address 
OC — OF Virtual CAW 


10-13 Flag bytes (NCBFLAGS) 
14-15 Error code (ERCOD) in NCB or zero 
16-17 NCB sense data in NCBSENSE or zero 


18-—1F Zero 
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TPESC 
Entry: ESC 
viT Option: ESC 
Event: TPESC Macro 
viT Processing Module: ISTRACOT 
Control is Returned to: ISTESCO1 
Applies to: MVS, VM, VSE 


This trace record identifies the address of the next routine to get control in a desti- 
nation vector table (DvT). The PAB address identifies the process. Using the RPH 
address, you can correlate this trace record to the DisP entry to find when the 
process was dispatched. 


tp Hadi di she sala aHeh 
de Ad db slalals ha AR 


P |DISP PAB RETURN |RPH MODULE |RPH 
A {ADDRESS | ADDRESS | ADDRESS | WORK NAME ADDRESS 
ELEMENT |or DVT 
ADDRESS 


Byte (hex) Contents 
00 —03 Record ip: Cesc’ 
04 ID 
e For mvs, address space !D 
(or zero if address space ID is greater than X'FF') 
e For vm, machine and task ID 
¢ For VSE, task ID 


05 Zero 

06 — 07 PAB offset 

08—-0OB Dispatch address from DVT 

OC — OF PAB address 

10-13 Address of the issuer of the TPESC macro 

14-17 RPH work element 

18-—1B Module name abbreviation (bytes 4, 5, 7, and 8 of the name of the next 
module to get control), or PAB DvT address (high order bit of X'18' = 0) 

1C—-1F RPH address 
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EXIT 


TPEXIT 
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Entry: EXIT 

vIT Option: PSS 

Event: TPEXIT Macro 
viT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCTX 
Applies to: MVS, VM, VSE 


This trace record identifies a VTAM process (PAB) that has finished executing. The 
PAB is rescheduled if more work elements are waiting to be processed. 


In most cases, the RPH (whose address is in location 1C — 1F) is freed or reused 
after this entry. The two exceptions are the front end message PAB (ATCFEMPB — 
module ISTCFCFG) and the SMS dynamic expansion DYPAB (ATCPXPAB — module 
ISTORFPX). These two PABS have dedicated RPHs that are not used for anything else. 


This entry is the complement of bisPp. An ExiT should eventually follow every DISP. 
Use the RPH address to correlate the entries. 


OOO/O;O/O;O;O;O/O;O/O;O;O;O;O;L|A;T;LJLiLiApLp1pDpaylplydyayl 
O}1)2;3)4/ 5/67) 8/9 ALBIC|DI EJF} 0} 142/314) 5] 6) 7/8; 9 ABC DI E}F 


P {PST PAB RETURN | WORK MODULE |RPH 

A |ADDRESS |} ADDRESS} ADDRESS | ELEMENT | NAME ADDRESS 
or DVT 
ADDRESS 


Byte (hex) Contents 
00-03 Record 1D: C’EXIT’ 
04 ID 
e For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For vm, machine and task ID 
e For VSE, task ID 


05 TPEXIT options (see field APNFLGS in control block iSTAPNOP in VTAM 
Data Areas) 

06 —07 PAB Offset, or zero if no PAB (see note) 

08—OB PST address 

OC —OF PAB address, or zero if no PAB (See note) 

10-13 Address of the issuer of the TPEXIT macro 

14-17 PAB work element queue, or zero if no PAB (see note) 

18-—1B Module name abbreviation (bytes 4, 5, 7, and 8 of the name of the next 


module to get control), or PAB DVT address (high order bit of X'18' = 
0), or zero if no PAB (see note) 
10—1F RPH address 


Note: There is no PAB if the running process has already freed the major control 
block that contains the PAB. 
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FREEBLK 
Entry: 
viT Option: 
Event: 
vit Processing Module: 
Control is Returned to: 
Applies to: 


FBLK 

SMS 

FREEBLK Macro 
ISTRACSM 
ISTCPCSM 

MVS, VM, VSE 


FBLK 


This trace record provides the status of each FREEBLK request issued by VTAM com- 


ponents. 


The FREEBLK macro is the complement of the GETBLK macro. FREEBLK must release 
the storage obtained by GETBLK. Each GBLK entry should eventually have a corre- 


sponding FBLK entry. 


If the return code is non-zero, this entry is generated whether the Sms option is in 
effect or not. This event is treated as an exception condition, and therefore, is 
traced whenever the vit is active. 


Byte (hex) Contents 


Olololololololololololojololololzlalalafalafajatalalafatatalali 
OLLIZIZI4(S5IGI7ZISIDIAIBICIDIE|FIOI1/2/3/415/6/7|8/9IAIBICIDIE|F 


STORAGE|ADDRESS|RETURN |LENGTH |CALLER | RETURN 
ADDRESS | OF 


(or zero if address space ID is greater than X'FF') 
e For vM, machine and task ID 


00 —03 Record 1D: C‘FBLK’ 

04 ID 
e For mvs, address space !D 
¢ For VSE, task !D 

05 Zero 

06 


Pool Contains 


Storage pool type (in hex): 


0O §# Private RUPE 

01 Common RUPE 
O02  VTAM private SIB 
03 SSCP FMCB 

04 #£=Not used 

05 DVT/EPT 

06 Dynamic CORSC 
07 ACDEB/APPCB 

08  HSQH 

09 ERTE 

OA  WRE and EID 

OB  FMCB extension 
OC  siB extension 
OD RSQE 

OE UECB/VRPL 

OF  IOBLOCK 
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07 

08—-0B 
OC — OF 
10—13 
14-17 
18—1B 


1C—-1F 


10 
11 

12 
13 
14 
15 
16 
17 
18 
19 
1A 
1B 
1c 
1D 
1E 
1F 
20 
21 

22 
23 
24 
25 
26 
27 
28 
29 
2A 
2B 


zero 
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SRTE 

NetView trace element 
UTILPOOL/UTILPVTS 
Message timer blocks (DMTSQ) 
VTAM private POWE 
Common POWE 
PULURDTE 

PAQ 

RAQ 

CPWAPVT 

ERICPOOL 

SIBIX 

CDAJSCP 

GWNAJSCP 

IOSIB 

DSSIB 

UTILPVTL 

UTILCSAS 

UTILCSAL 

AMU 

HSICB 
LMHDR/LME/LMM 
SAB/NSI 

RAB 

PRIDBLK 

PRIDQAB 

OCB/NACP 
CPWACSA 


Address of block freed (or zero if FREEBLK failed) 

Address of storage pool anchor block (SPANC) 

Address of the issuer of the FREEBLK macro 

Length of storage freed 

Caller of utility routine or zero. If the FREEBLK macro was issued from 
a utility routine, then the address of the utility’s caller is placed here. 
A zero address means that the macro was issued directly by the caller 
(see return address) without a utility routine. | 
Return code 
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GBLK 


GETBLK 
Entry: GBLK 
VIT Option: SMS 
Event: GETBLK Macro 
viT Processing Module: ISTRACSM 
Control is Returned to: ISTCPCSM 
Applies to: MVS, VM, VSE 
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This trace record provides the status of each GETBLK request issued by VTAM com- 
ponents. 


The FREEBLK macro is the complement of the GETBLK macro. FREEBLK must release 
the storage obtained by GETBLK. Each GBLK entry should eventually have a corre- 
sponding FBLK entry. 


If the return code is non-zero, this entry is generated whether the sms option is in 
effect or not. It is treated as an exception condition and is always traced, regard- 
less of the SMS option, if the viT is active. 


O/O;O/O/O/OO;O/O/O;/O/O;O;O;O;O; DTI A;PLILI Li LyapLylpdylylpyly1p iyi 
Oy 1Lj2; 3/4) 5/6; 718/9 AI BIC IDI E| FIO} 14 2)3)4)5)6)7/8/9 A; BIC} DIE|F 


GBLK i STORAGE |ADDRESS|RETURN |LENGTH |CALLER | RETURN 


ADDRESS | OF ADDRESS | OF 
STORAGE | UTILITY 
REQUESTior 0 
Byte (hex) Contents 
00 —03 Record ID: C‘'GBLK'’ 
04 ID 


¢ For mvs, address space Ip 
(or zero if address space ID is greater than X'FF') 
e For vM, machine and task ID 
e For VSE, task ID 
05 ~ Zero 
06 Buffer pool type (in hex): 

Pool Contains 

0O # Private RUPE 

01 Common RUPE 

02 + VTAM private SiB 

03 SSCP FMCB 

04 #£=Not used 

O05 DVT/EPT 

06 Dynamic CDRSC 

O07 ACDEB/APPCB 

08  HSQH 

09 ERTE 

OA WRE and EID 

OB FMCB extension 

OC siB extension 

OD  RSQE 

OE UECB/VRPL 

OF  IOBLOCK 


—- Ooo vw 
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07 

08 - 0B 
OC — OF 
10-13 
14-17 
18—-1B 


1C— 1F 


10 
11 

12 
13 
14 
15 
16 
17 
18 
19 
1A 
1B 
1C 
1D 
1E 
1F 
20 
21 

22 
23 
24 
25 
26 
27 

28 
29 
2A 
2B 


Zero 
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SRTE 
NetView trace element 
UTILPOOL/UTILPVTS 
Message timer blocks (DMTSQ) 
VTAM private POWE 
Common POWE 
PULURDTE 

PAQ 

RAQ 

CPWAPVT 

ERICPOOL 

SIBIX 

CDAJSCP 

GWNAJSCP 

1OSIB 

DSSIB 

UTILPVTL 

UTILCSAS 

UTILCSAL 

AMU 

HSICB 
LMHDR/LME/LMM 
SAB/NSI 

RAB 

PRIDBLK 

PRIDQAS 

OCB/NACP 

CPWACSA 


Address of block obtained (or zero if GETBLK failed) 

Address of storage pool anchor block (SPANC) 

Address of the issuer of the GETBLK macro 

Length of storage request 

Caller of utility routine or zero. If the GETBLK macro was issued from a 
utility routine, then the address of the utility’s caller is placed here. 
Return code 
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Halt I/O 
Entry: HIO 
VIT Option: ClO 
Event: Halt 0 
vIT Processing Module: ISTRACCI 
Control is Returned to: ISTTSCLR 
Applies to: MVS, VM, VSE 


This trace record is written when a Halt i/o svc is issued to end a currently exe- 
cuting channel program. This should be followed shortly by an interrupt (INT) entry. 
Be sure to match the CuAs in the HIO and INT entries to be sure they are for the 
same device. See VTAM Data Areas for a description of the NCB and xcnces fields. 

] 


slelel spe 1yj1}1 ma Pal 
rae reali SHRP OIA 


HE 
HIOB {I 
HIOH |D 
HIOX 


Ore COO = 


CUA |NCB FLAG 
ADDRESS| BYTES 


Byte (hex) Contents 
00-03 Record ID: C‘HIOB’, ‘HIOH’, or ‘HIOX’ 
04 ID 
¢ For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
¢ For VM, machine and task ID 
¢ For vSE, task ID 
05 For HloB, link station state (BSCLKFSM) 
For HIOH, link station state (HALLFSM) 
For HIOX, station state (XCNSSFSM) 


06 — 07 Module Ip (last 2 characters of TSC module name) 

08 Zero 

09—-0B Channel device name in Escoic (either a CUA or device number) 
OC — OF NCB address 

10—13 Flag bytes (NCBFLAGS) 


14-1F Zero 
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vm vse Halt I/O (V3R1.2 and Later) 


Entry: VM VSE HIOP 

vIT Option: ClO 

Event: Start 1/0 

vit Processing Module: ISTRAC6T 

Control is Returned to: ISTTSC6L Or ISTTSCEP 

Applies to: VM (V3R1.2 and later), VSE (V3R2) 


This trace record is created when a Halt 1/0 Svc is issued to end a currently exe- 
cuting channel program. This may be followed by an interrupt (INT) entry. Match 
the CUAs in the HIO and INT entries to be sure they are for the same device. A Halt 
I/O SVC is issued against each of four CUuAs during initialization or termination of the 


Token-Ring Subsystem. 
eee ePaParererarararararan 
213/4/516)7/8/9/AIBIC|DIEIF 


0/0/0/0)/0)0)/0/0)0)0;0)0)0)0;0;0)1)1 
O}14)2;3/4)5/6; 78/9) A|BIC|DIE}FIO}1 


HIOP |I/C CUA |NCB 
D}P ADDRESS 
F 
S 
M 


Byte (hex) Contents 
00-03 Record ID: C‘HIOP' 


M 
0 
D 
I 
D 


ror oO DU 


04 Machine and task ID 
05 Channel program FSM 
0O =«Reset 


01 Sense ID 

02  ~=Interrupt port 

03 Control port 

04 Running 

05 Sense 

06 Orderly halt (HLTC) 
07 Termination 

08 Shutdown 


06 —07 Module ID (last 2 characters of Tsc module name) 
08 Zero 
09—-0OB Channel device name in EBCcDic (either a CUA or device number) 
OC —OF NCB address 
10 Port state (PDATA) 
00 Reset 
01 Halt 


02 Halt complete 

03 Sense 1D 

04 Sense ID complete 
05 = Interrupt pending 
06 Active 

07 Sense 
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11 Port type (PDATA) 
CO = s Interrupt 
01 Control 
02 Inbound 


03 Outbound 
12—1F Zero 
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mvs INT 


mvs Interrupt 
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Entry: Mvs INT 

vIT Option: CIO 

Event: Channel Interrupt 
vIT Processing Module: ISTRACCI 

Control is Returned to: ISTTSCLC 

Applies to: MVS 


This trace record is written when a channel program interrupt occurs. 


Every INT entry has a previously issued sio entry, although it may have been issued 
some time ago. Use the cua field to correlate sio and INT entries. The sio entry 
provides additional information about this completing channel program. 


See VTAM Data Areas for a description of the NcB fields. See the diagnostic 
manuals for your operating system for a description of the 1os fields. 


O}O;O/OLO/OO/O;O;O;O;O/O;O;O;O;LIL{T{ 1 1ylyayl 
O}1)2)/3)4/5/6/7/ 8/9; A|BIC|DIE}FIO}1)2)3)4)5)6)7 


INTI JIJSIE CUA |NCB FLAG |FICIS o CSW 
INTL |D/T}O ADDRESS} BYTES |LIOJE r 
INTX A|P A|D 

TIC GIE|S 0 

E}D 


Byte (hex) Contents 
00-03 Record ID: 
C'INT! for ICNCB 
C'INTL’ for LONCB 
C‘INTX’ for XCNCB 
04 Address space ID (or zero if address space ID is greater than X'FF') 
05 Link station state (NCBLNKST) for ICNCB and LONCB 


Mmm 2m 


Station state (XCNSSFSM) for XCNCB 


06 Ending operation code 
07 —08 Zero 
09—-OB Channel device name in Escpic (either a CUA or device number) 
OC — OF NCB address 
10-13 Flag bytes (NCBFLAGS) 
14 Flag byte as follows: 
Bit Meaning 
Lgtae ~alQaet Running in disabled interrupt exit (IOSDIE is not zero) 
ae ee ERP work area address exists (IOSERP is not zero) 
Sb lee. cbse Exception condition (IOSEx flag is on) 
re eee Error routine in control (1OSERR flag is on) 
15 10 completion code: !1OSCOD 
16-17 Sense data in IOSSNS if this was a sense channel program; otherwise, 
zero 
18—1F Channel status word from !oss. 
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vm Interrupt (Part 1) 
Entry: 
viIT Option: 
Event: 


viT Processing Module: 


Control is Returned to: 
Applies to: 


This trace record is written when a channel program interrupt occurs. 


vm INT 

CIO 

Channel Interrupt (Part 1) 
ISTRACCI 

ISTTSCLC 

VM 


vm INT 


Every INT entry has a previously issued sio entry, although it may have been issued 
some time ago. Use the cua field to correlate sio and INT entries. The sio entry 


provides additional information about this completing channel program. 


See VTAM Data Areas for a description of the ncB fields. See the diagnostic 


manuals for your operating system for a description of the ios fields. 


ANAK 2 Te 


INTL 
INTX 


Byte (hex) Contents 
00-03 Record ID: 


mArPrudHiMm 
on vam 


re i. Re =e ee ee 


db a ba AHR aE 
oe dPep iH AMP 


CUA {NCB FLAG 
ADDRESS} BYTES 
CUA {NCB FLAG |FIC|S o CSW 
ADDRESS| BYTES |L/OJE r 
A\DIN 
GIES 0 
E 


INTB JTIL NCB FLAG Ci S 
or DIF ADDRESS| BYTES O; E 
INTH S D} N 
M EI S 

E 

INTI L CUA |NCB FLAG C} S 
N ADDRESS| BYTES QO} 

K Di N 

S Ey $ 

T E 


moo o 


C'INTB’ for BSCTYPE 
C'INTH’ for HALTYPE 
C'INTI for ICNCB 
C'INTL’ for LONCB 
C'INTX' for XCNCB 
04 Machine and task !D 
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CSW 
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05 For INTB and iNTH, link finite state machine (LFSM) 
For iNT! and INTL, link station state (NCBLNKST) 
For INTX, Station state (XCNSSFSM) 


06 Ending operation code or zero 
07 —08 Zero 
09—0B Channel device name in EBcDic (either a CUA or device number) 


OC — OF NCB address 

10-13 Flag bytes (NCBFLAGS) 

14 Flag byte as follows, or zero 
Bit Meaning 
1... .... Running in disabled interrupt exit (lOSDIE is not zero) 
-l.. .... | ERP work area address exists (IOSERP is not zero) 


ry ee Exception condition (tosex flag is on) 
.-l1...- Error routine in control (IOSERR flag is on) 
15 0 completion code: !0SCOoD 
16-17 NCB sense data in NCBSENSE if this was a sense channel program; oth- 
erwise, zero 
18—1F Channel status word from NCB. 
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vm Interrupt (Part 2) 


Entry: vv INT2 

VIT Option: ClO 

Event: Channel Interrupt (Part 2) 
vIT Processing Module: ISTRACCI 

Applies to: VM 


This trace record is a continuation of the INT entry. 


l 


0/0/0/0/0/0/0/0/0/0/0/0/0/0/0/0;1)1 
QO; 1) 2;3)4, 5,6; 7/8) 9/A;Bi CD] E; FiO; 


vM INT2 


INT2 DEVICE-DEPENDENT 
INFORMATION 


Byte (hex) Contents 

00-03 Record 1p: C'INntT2’ 

04-07 Zero 

08-13 Device-dependent information shown below 


14-1F 


Zero 


For spc links (NCBTYPE = 09): 


08 Return code 

09 Buffer offset (SPLOFFST) 

OA SDLC station address (SPLADODR) 

OB Control flag (SPLCTLFG) 

OC Current SDLC number of last |-frame sent (SPLNSCUR) 
OD Last acknowledged I-frame (SPLNSACK) 

OE Next I-frame to be received (SPLNRACC) 

OF Command-in field (SCXCMDIN) 

10 Count of frames sent and acknowledged (SCXCFRS) 
11 SCXCRBUF 

12-13 Exception flags and exception code (SCXEXFCD) 


For BSc links (NCBTYPE=0A): 


08 First selection character (BSCSEL1) 

09 First device address (BSCDEV1) 

0A Index of BPL entry for which input data was received (BSCPESV) 
0B Device address from which input data was received (BSCDEVSV) 
OC Index for last station for which there was output data (BSCISOD) 
OD First response byte (BSCRSPA1) 

OE Second response byte (BSCRSPA2) 

OF Last block type received (BSCLBR) 

10 Current acknowledgment (BSCALTAK) 

11 Error retry count (BSCRCNT) 

12 Connection manager flags (BSCCMIO) 

13 BSC flags (BSCFLAGS) 
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VM VSE Interrupt (V3R1.2 and Later) 


Entry: VM VSE INT 

VIT Option: ClO 

Event: Start 1/0 

viT Processing Module: ISTRACE6T 

Control is Returned to: ISTTSC6E 

Applies to: VM (V3R1.2 and later), VSE (V3R2) 


This trace record is created when a channel program interrupt occurs. 


If the INT entry signals the completion of a channel program, it has a previously 
issued SiO entry, although it may have been issued some time ago. Use the CUA 
field to correlate sio and INT entries. The sio entry provides additional information 
about this completing channel program. If the CUA field contains the address speci- 
fied on the PORT statement, this INT entry may not be related to an SIO entry. 


0)0/0/0)0)0 of ele cree a ob lb 
Q0}142/3)4]5 a lalalels 


INTP |IIC CUA |NCB CiS ENDING CSW 
D ADDRESS OVE 
DIN 
ES 
E 


Byte (hex) Contents 
00-03 Record 1D: C'INnTP’ 


=r HAWN 


=nn UV 


04 Machine and task ID 
05 Channel program FSM 
00 Reset 


01 Sense !D 
02  ~=Interrupt port 
03 Control port 
04 Running 
05 Sense 
06 Orderly halt (HLTC) 
07 Termination 
08 Shutdown 
06 — 08 Zero 


09—-0B Channel device name in EBcoic (either a CUA or device number) 
OC — OF NCB address 
10 Port state (PDATA) 

OO Reset 

01 Halt 


02 + Halt complete 

03 Sense ID 

04 Sense ID complete 
05  ~=Interrupt pending 
06 Active 

07 Sense 
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11 Port type (PDATA) 
00 = Interrupt 
01 Control 
02 Inbound 


03 Outbound 
12-13 Zero 
14 VO stimulus for FSM manager 
06 Normal completion 
07 § Attention 
08 Attention and unit exception 
09 Unit check 


OA Error 

15 Channel-command code for the last ccw 
04 Sense (3088 compatibility) 
08 Tic 


C1 Data buffer write 
C2 Data buffer read 
C4 Sense control unit state 
C5 Control block write 
C6 Control block read 
C7 Data synchronization 
C9 Data parameters write 
CB Set CET! mode on 
CD Interrupt parameters write 
E4 Sense Ip 

16 First byte of sense data 
80 Command reject 
02 Control! block reject 

17 Zero 

18—-1F Channel status word. 
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vse INT 


vse Interrupt (Part 1) 
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Entry: VSE INT 

VIT Option: ClO 

Event: Channel Interrupt (Part 1) 
VIT Processing Module: ISTRACCI 

Control is Returned to: ISTTSCLC 

Applies to: VSE 


This trace record is written when a channel program interrupt occurs. 


Every INT entry has a previously issued sio entry, although it may have been issued 
some time ago. Use the cua field to correlate sio and INT entries. The sio entry 
provides additional information about this completing channel program. 


See VTAM Data Areas for a description of the ncB fields. See the diagnostic 
manuals for your operating system for a description of the !os fields. 


Hb eels = 1}1 
4H eels eal lalals 7\8 


NCB FLAG S 
ADDRESS| BYTES E 
N 
S 
E 
NCB FLAG 
ADDRESS| BYTES 
CUA |NCB FLAG 
ADDRESS| BYTES 


Byte (hex) Contents 

00 — 03 Record ID: 
C'INTB’ for BSCTYPE 
C'INTH’ for HALTYPE 
C'INTI for ICNCB 
C'INTL’ for LDNCB 


= 
= 
nN © 
wo 
oO 
mn 


m OO © 


— O mH 
ae Ss ee 
4 — 
x co 
i 
= nn mo 


CSW 


AO YP Dam 
Oo oO NON wDMmM 
moon 


AO YP Dam 


04 Task ID 
05 For INTB and INTH, link finite state machine (LFSM) 
For iNTI and INTL, link station state (NCBLNKST) 
06 ERACT or zero 
07 —08 Zero 
09—-0B Channel device name in Escoic (either a CUA or device number) 
OC — OF NCB address 
10-13 Flag bytes (NCBFLAGS) 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


“Restricted Materials of IBM” vse INT 
Licensed Materials — Property of IBM 


14 ERCOD or zero 

15 Oo completion code: 1oscoD 

16—17 NCB sense data in NCBSENSE if this was a sense channel program; oth- 
erwise, zero 

18—1F Channel! status word from NCB. 
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vse Interrupt (Part 2) 


Entry: VSE INT2 

viT Option: ere) 

Event: Channel Interrupt (Part 2) 
vit Processing Module: ISTRACCI 

Applies to: VSE 


This trace record is a continuation of the INT entry. 


Ai bl bb Oli} 


6)7)/8/9)A|B)C{DIE|FIO}1 
DEVICE-DEPENDENT 


INFORMATION 


Byte (hex) Contents 

00-03 Record 1D: C'INT2’ 

04-07 Zero 

08-13 Device-dependent information shown below 
14-—1F Zero 


For SDLC links (NCBTYPE = 09): 


08 Return code 

09 Buffer offset (SPLOFFST) 

OA SDLC station address (SPLADDR) 

0B Control flag (SPLCTLFG) 

0C Current SOLC number of last I-frame sent (SPLNSCUR) 
OD Last acknowledged I-frame (SPLNSACK) 

OE Next I-frame to be received (SPLNRACC) 

OF Commana-in field (SCXCMDIN) 

10 Count of frames sent and acknowledged (SCXCFRs) 
11 SCXCRBUF 

12-13 Exception flags and exception code (SCXEXFCD) 


For BSC links (NCBTYPE =0A): 


08 First selection character (BSCSEL1) 

09 First device address (BSCDEV1) 

OA Index of BPL entry for which input data was received (BSCPESV) 
OB Device address from which input data was received (BSCDEVSv) 
0C Index for last station for which there was output data (BSCISOD) 
OD First response byte (BSCRSPA1) 

OE Second response byte (BSCRSPA2) 

OF Last block type received (BSCLBR) 

10 Current acknowledgment (BSCALTAK) 

11 Error retry count (BSCRCNT) 

12 Connection manager flags (BSCCMIO) 

13 BSC flags (BSCFLAGS) 
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vm vse Interrupt (V3R1.2 and Later) 


Entry: VM VSE INT 

vIT Option: ClO 

Event: Start 1/0 

viT Processing Module: ISTRACTR (SNAP trace recording routine) 
Control is Returned to: ISTAPCES 

Applies to: VM VSE (V3R1.2 and later) 


This trace record provides information about interruptions at the telecommuni- 
cations subsystem or communication adapter interface. An entry is built for each 
/O interrupt for an x.25 port. 


The telecommunications subsystem or communication adapter uses two channel 
programs: acontrol link channel program and a buffer pool channel program. 


OO/O;O;O/O/O/O;O/O/O;O;OO;O;O;LpLpA;L{Lj1j1jiy1)1 
O11)2/3/4)5]6)/7/8/9/AIBIC|DIE|FIO}1);2)3)4)5|6}7)|8)9 


SENSE STATUS CCW 


Byte (hex) Contents 
00-02 Record !D: C‘INT’ 


03 Type: 
OC = Control link channel program 
OD = Buffer pool channel program 
04 Machine and task ID 
05—07 Channel device name in EscoDic (either a CUA or device number) 
08 —09 Channel status word from NCB 
OA-—1B NCB sense data in NCBSENSE 
1C=—1F NCB address 
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TPIO Request (Part 1) 


418  VTAM Diagnosis 


Entry: 101 

vIT Option: API 

Event: TPIO Request, Part 1 
vit Processing Module: ISTRACAP 

Control is Returned to: ISTAPCRS or ISTOCCSM 
Applies to: MVS, VM, VSE 


This trace record shows AP! requests. It also provides the RPL information supplied 
by a VTAM application program when it issues an RPL-based macroinstruction (such 
aS SEND Or OPNDST). The APi routine ISTAICIR issues the TPIO SVC. ISTAPCTI gets control 
from the svc, does validity checking, and queues the RPL to the PST request PAB. 
After the PST request PAB is dispatched, ISTAPCRS gets control and writes the entry, 
or calls ISTOCCSM to write the entry. 


See VIAM Data Areas for an explanation of the RPL fields. 


The process that is started with this event will be completed by a post (uP), or an 
exit (RE Or UE). To correlate the two entries, match the RPL addresses. 


OO;O/O/O/O/O/O;O;O;O;O;O;O;O;O;LILILILiLiLiLiLiLy@paylpayayay. 
O}1/2)3)4)5)6) 78,9 AIBIC|DIE}FIO11)2)3)4)5)6)7)8)9}AIBICiDIE|F 


101 T}E}O}O}RPL U OPTC2 | OPTC3 
D| X P} ADDRESS | ADDRESS NTL 
T T 
D} jl 
S 
Byte (hex) Contents 
00 —02 Record 1D: C'101' 
03 RPL request type (RPLREQ) 
X'15' SETLOGON 
X'16' SIMLOGON 
X'17' OPNDST 
X'1A' INQUIRE 
X'1B'  INTRPRET 
X'1F' CLSDST 
X'22' SEND 
X'23' RECEIVE 
X'24' RESETSR 
X'25' SESSIONC 
X'27' SENDCMD 
X'28' RCVCMD 
X'29' REQSESS 
X'2A' OPNSEC 
X'2C' TERMSESS 
04 ID 


e For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For VM, machine and task Ip 


e For VSE, task ID 
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05 
06 
07 
08 — 0B 
OC — OF 
10 
11 
12 
13 
14 
15-17 
18-1B 
1C—1F 
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Exit definition (RPLEXTDS) 
Zero 

Option code byte 1 (RPLOPT1) 
RPL address 

Nis address or CID 

Third byte of RH (RPLRH3) 
Send/receive type (RPLSRTYP) 
VTAM flags (RPLVTFL1) 
Post/respond flags (RPLVTFL2) 
RU chain position (APLCHN) 

RU control codes (RPLCNTRL) 
VTAM options (RPLOPTC2) 
VTAM options (RPLOPTC3) 
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mvs vse TPIO Request (Part 2) 


420 ~VTAM Diagnosis 


Entry: MVS VSE 102 

vit Option: API 

Event: TPIO Request, Part 2 
vit Processing Module: ISTRACAP 

Applies to: MVS, VSE 


This trace record is a continuation of the 101 entry. It shows additional information 
about the PLU and SLU in a session established or terminated by a SIMLOGON, OPNDST, 
CLSDST, REQSESS, OPNSEC, Or TERMSESS macroinstruction. This information includes 
some of the parameters exchanged and the names of the PLU and SLU. 


OVOPOLO;OJOJO;O;OlO;O;OjO;O;O;O;L LiL; AUpLiL;ApL]DjaAyl{Ljlyayiyl 
0/1)2)/3/4)5}6]7/8)9/A/BiC]DIE} FiO] 1)2)3)4)/5)6)7)/8)/9|A|B/C}DIE|F 


RETURN |LOGON MODE NAME}PLU NAME SLU NAME 
(if available) |(if available) 


Byte (hex) Contents 
00 —02 Record 1p: C'lo2’ 


03 Zero 
04—07 Address of the issuer of the macro 
08 — OF For SIMLOGON, OPNDST, CLSDST, Or REQSESS: Logon mode name 


(NIBLMODE) or zero if the NiB is not available 
For OPNSEC or TERMSESS: Zero 

10-17 PLU name or zero 

18—-1F SLU name or zero 
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mvs vsE TPIO Request (Part 3) 


Entry: MVS VSE 103 

viT Option: API 

Event: TPIO Request, Part 3 
vIT Processing Module: ISTRACAP 

Applies to: MVS, VSE 


This trace record is a continuation of the 102 entry. It shows additional information 
in a session established or terminated by a SIMLOGON, OPNDST, CLSDST, REQSESS, or 
OPNSEC macroinstruction. 


ae O/O;OPO/O;OPLAA;APLPLILiLpLylylpLiljplyayayl 
cllgielalatcta elelalaeaialeteaielelaelclate 


ADDRESS 


OF USER 
DATA, 
BIND, 
or 0 


Byte (hex) Contents 
00-02 Record 1D: C'l03’ 


03 Zero 

04-07 For SIMLOGON, CLSDST, or REQSESS: Address of user data (RPLAREA) 
For OPNDST or OPNSEC: Address of BIND (NIBNDAR) or Zero if the NiB is not 
available 


08 —1F zero 
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vM TPIO Request (Part 2) 


422  VTAM Diagnosis 


Entry: VM 102 

VIT Option: API 

Event: TPIO Request, Part 2 
viT Processing Module: ISTRACAP 

Applies to: VM 


This trace record is a continuation of the 101 entry. It shows information about the 
PLU and SLU, such as some of the parameters exchanged and the names of the PLU 


and SLU. 
OO/OO;/O/O;O;O LILI LILILTpLiLilyli_iljiijlyijifi 
BIDIAIBICIDIE]FIJOILIZ1I3/4/51/6)7/8/9/AIBICIDIE|F 


0/0/0/0/0/0}0)0 

0}1)213)4|516}7 

102 RETURN |LOGON MODE NAME}PLU NAME SLU NAME 
ADDRESS (if available) | (if available) 


Byte (hex) Contents 
00-02 Record 1D: C'1o2' 


03 Zero 

04-07 Address of the issuer of the macro 

08 — OF Logon mode name (NIBLMODE) or Zero if the NiB is not available 
10-17 PLU name or zero 

18—1F SLU name or zero 
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vM TPIO Request (Part 3) 
Entry: 
vIT Option: 
Event: 
viIT Processing Module: 
Applies to: 


VM 103 


VM 103 
API 
TPIO Request, Part 3 


ISTRACAP 
VM 


This trace record is a continuation of the 102 entry. 


0/0;0;0;0;0)0)0)0 
0} 1}213)4)5|6}7)8 


103 ADDRESS 
OF BIND 
or 0 


Byte (hex) Contents 


O;O;O;O;O; LLL Lidp@ylyljlp]iiiyiyl 
BICIDJE}F/O/1}2/3}4/5/6/7/8/9)AIBIC 


Address of BIND (NIBNDAR) or zero if the NiB is not available 


00-02 Record ID: C'103’ 
03 Zero 

04-07 

O08 —1F Zero 
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MVS IRBD 


MVS IRB Dispatch 
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Entry: MVS IRBD 
vIT Option: PSS 

Event: IRB Dispatch 
viT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCIE 
Applies to: MVS 


This trace record provides information when an IRB is dispatched. See the Debug- 
ging handbook for your operating system for a map of the TcB. 


Note: In addition to specifying the Pss option, you must also set the RACON bits to 
B‘1' for this trace record to be created. 


O;,O/O/O;O;OO;O;O/O;O/O;O;O;O;OL LIL Lp LiLyA{LiLilpi_ylylityiiiil 
O11)2)/314/5)6); 7/8) 9}A|BIC DIE] FIO} 1) 2)/3/4)5]6]7/8) 9] A; BIC|DIE]F 


IRBD jI PST IRB TCB F 
D ADDRESS | SYNC ADDRESS| ADDRESS} L 
TPPOSTD | NORMAL G 

] 


Byte (hex) Contents 
00-03 Record 1D: C'IRBD’ 

04 Address space ID (or zero if address space ID is greater than X'FF') 
05—07 Zero 


08 —0OB PST address 


OC — OF PST synchronous TPPOSTed queue anchor (PSTSTPP) 
10-13 PST synchronous normal queue anchor (PSTSNRM) 
14-17 IRB address (TCBRBP) 

18-1B TCB address (PSTTCBA) 


1¢-—1D PST flags (PSTFLG1) 
1E—1F Zero 
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mvs IRB Exit 
Entry: mvs IRBX 
ViT Option: PSS 
Event: IRB EXIT 
viT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCSD 
Applies to: MVS 


This trace record provides information about an IRB exit. 


Note: In addition to specifying the PSs option, you must also set the RACON bits to 
B‘1' for this trace record to be created. 


OO;O/O/O;O;O;O/O;O;O;O/O;O;O;O;L{LiL{ApLPLiLyapylplydpalplyiyayl 
O}1]2)3;415/6;7/B/9{A/BIC DIE; FIO; 1;2)314/5/6/7; 8/9; A; BIC| DJ EJF 
IRBX |I PST NEW TCB/OLD TCB|NEW IRB 
D ADDRESS | ADDRESS | ADDRESS | ASCB 
ADDRESS | ADDRESS 


Byte (hex) Contents 

00-03 Record 10: C'IRBX’ 

04 Address space ID (or zero if address space ID is greater than X'FF') 
05-07 Zero 

08—-OB PST address 


OC — OF New TcB address 
10123 Old TcB address 
14—17 New AScB address 


18—1B Old ASscB address 
1C—1F IRB address 
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vM VSE LAN Interface Control (V3R1.2 and Later) 


Entry: VM VSE LIC 

VIT Option: ClO 

Event: Start 1/0 

VIT Processing Module: ISTRAC6T 
Control is Returned to: ISTTSCE6R for LICI 


ISTTSC6W for LICO 
ISTTSC6K Or ISTTSCER for LICS 
Applies to: VM (V3R1.2 and later), VSE (V3R2) 


One of these trace records is created when a command is sent to or received from 
the Token-Ring Subsystem. 


An Lici record is written when a command is received from the subsystem. This 
entry always corresponds to a previous ADPA or ADP! entry. Use the TscB address to 
correlate these entries. 


An LICO record is written when a command is ready to be sent to the subsystem. If 
the command is transferring a PiU onto the ring, it corresponds to a previous PIU 
entry. The TSCB continuation address of the LICo entry correlates to the TSCB 
address of the Piu entry. 


An LiICs record is written when a special condition related to controlling the sub- 
system is detected. 


a alee’ yeaa ala Hn 
dbp aera? He alola 


LICI TSCB C} CMD | T V F |TSCB 
ADDRESS sn F F L {CONT 
S > A |ADDRESS 
M M G 
S S > 
REASON 


OO es 


CUA | TSCB NCB C} CMD 
ADDRESS | ADDRESS |B 
I 
D 


Byte (hex) Contents 

00-03 Record ID: 
C'tic!’ for an inbound record 
C‘LIco’ for an outbound record 
C'Lics' for a special record. 


04 Machine and task ID 

05-07 Channel device name in EBCDIC (either a CUA or device number) 
08 — 0B TSCB address 

OC — OF NCB address 

10 Control block ID of NCB 


OE NCB for local station (VTAM) 
OB wNcB for remote station 
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11-13 


14 


15 


vm vse LIC (V3R1.2 and later) 


Command 


See “vm vse Command Values Reported in Trace Entries” on page 297 
for more information about this field. 

LLC Port FSM (TFSMS) 

01 Logon pending 


02 Logon completion 
03 Logoff pending 

04 Enable pending 
05 Disable pending 


Channel Program FSM (TFSMS) 
OO Reset 
01 Sense ID 


02 ~=Interrupt port 

03 Control port 

04 Running 

05 Sense 

06 Orderly halt (HLTC) 
07 Termination 

08 Shutdown 


For LICI or LICO: 


16 

17 

18 
19-—1B 
1C—1F 
For LICS: 
16—-—1F 
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LLC Link Fsm if CBiO=X'OB' (vFSms) 


OO Reset 

10 = ACTLINK pending 
20 =Active 

30 DACTLINK pending 


LLC Connection FSM if CBID=X'0B' (VFSMS) 


00 Reset 

10 Connect in 

20 Connect out 

30 Connected 

40 xID pending 

LLC Station FSM if CBID=X'OB' (VFSMS) 
00 Reset 

10 XID zero pending 

20 Set mode pending 
30 Set mode wait 

40 Active state 

50 Request discontact 
60 Disconnect pending 


Remote station flags if caiD=X'0B' 
TSCB continuation address 


Special reason text: 


C'CLEAN UP’ VTAM has completed shutdown of the Token-Ring Sub- 
system. This entry is preceded by a LICS C'FINAL TERM’ 
entry. 

C'DISCARD' Subsystem input has been discarded. 


Channel programs to the subsystem have been 
stopped. 
VTAM ts initiating shutdown of the subsystem. 


C'FINAL TERM’ 


C'HALT RQST’ 
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Entry: LKEX 

viT Option: LOCK 

Event: TPLOCK Exclusive 
viT Processing Module: ISTRACLK 

Control is Returned to: ISTAPC36 

Applies to: MVS VM, VSE 


This trace record identifies a request for exclusive control of a vTAM lock and the 
current status of a lock. Exclusive locks can be held by only one vTAM process. 


When a TPWAIT entry immediately follows this entry, it cou/d be because a wait-for- 
lock condition exists. Look at the lockword in the trace output to see if the lock is 
already held. 


Locks obtained by LKEx are eventually released by UNLK or ULKA. See Figure 9 on 
page 42 for a list of VTAM locks. 


CRRCH ACH RCH ACH ACH RCH ECR ACH RCH RCRICH TCH ECHECH ICH OG pm mam 
O;1;2/3/4( 516] 7/8) 9jALBIC|DIE; FIO; 1)2)3 


LKEX |I/O}L L{LOCK CRA RETURN 
D} |O E;ADDRESS| LKACT |ADDRESS 

CV 

KE 

L 


LOCKWORD RPH 
ADDRESS 


Byte (hex) Contents 


00-03 
04 

05 

06—07 
08—0B 
0C — OF 
10-13 
14-1B 
1C—1F 
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Record 10: C'LKEX'’ 
ID 
e For Mvs, address space ID 
(or zero if address space ID is greater than X'FF’) 
¢ For vm, machine and task ID 
e For VSE, task ID 
Zero 
Level of lock to be obtained 
Address of lock to be obtained 
CRA lock account word (CRALKACT; see step 11 on page 41) 
Address of the issuer of the TPLOCK macro 
Lockword for above level of lock 
RPH address 
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TPLOCK Shared 
Entry: 
VIT Option: 
Event: 
viT Processing Module: 
Control is Returned to: 
Applies to: 


LKSH 

LOCK 

TPLOCK Shared 
ISTRACLK 
ISTAPC35 
MVS. VM, VSE 


LKSH 


This trace record identifies a request for a shared vTAM lock and the current status 


of alock. Shared locks can be held by more than one VTAM process at a time. 


When a TPWAIT entry immediately follows this entry, it cou/d be because a wait-for- 
lock condition exists. Look at the lockword in the trace output to see if the lock is 


already held. 


Locks obtained by LKEx are eventually released by UNLK or ULKA. See Figure 9 on 
page 42 for a list of VTAM locks. 


rn oe ee 


Byte (hex) Contents 


0/0/0/0/0/0)0)0)0;0;0}0)0)0)0)/0)1 
0)142/3)4)5)/6)7/8)9;A;B/C/DIE; FIO 


LKSH {IjO;L L}LOCK 
D} |}O E}ADDRESS 
C 
K 


CRA RETURN 
LKACT |ADDRESS 


¢ For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For vM, machine and task ID 


Level of lock to be obtained 

Address of lock to be obtained 

CRA lock account word (CRALKACT; see step 11 on page 41) 
Address of the issuer of the TPLOCK macro 


00-03 Record 1D: C'LKSH' 
04 ID 
e For VSE, task ID 
05 Zero 
06 — 07 
08 —0B 
OC — OF 
10-13 
14—1B Lockword 
1C—1F RPH address 
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LyLplplylplpdylylydjijiyiyl 
1}2|3}4/5|6|7|8/9)A|BiC}/D|E|F 


LOCKWORD RPH 
ADDRESS 


l 


429 


LOST 


Lost Trace Record 
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Entry: LOST 

viT Option: N/A 

Event: Lost Trace Record 

viIT Processing Module: ISTRACRR 

Control is Returned to: The location shown in register 14 
Applies to: MVS; VM, VSE 


This trace record indicates that the internal trace table is incomplete. Information 
from events that were supposed to be traced was lost because there were not 
enough save areas available for the tracing routine to record the information. 


OO/O/O/O/OO;O/O/O;O;O;O;O;O;O; AL] LiLpLyLplyLy@ylp1ya_yay. 
0}1)2)3)4/5;6]7/8)9{A/BIC|DIE} FIO} 1/2)/3)4)5)/6)7)8)9)/A;B\C{D 


LOST a REG 14 LOST TRACE RECORD 
D 


Byte (hex) Contents 
00-03 Record ID: C'LosT’ 
04 ID 
e For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For VM, machine and task ID 
¢ For VSE, task ID 
05—07 Zero 
08—OB Register 14 (return address) 
OC —1F C'LOST TRACE RECORD’ 
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TPMSG or CPMSG (Part 1) 


Entry: MSG 

VIT Option: MSG 

Event: TPMSG Macro or CPMSG Macro (Part 1) 
vIT Processing Module: ISTRACOT 

Control is Returned to: ISTCFCTM 

Applies to: MVS, VM, VSE 


This trace record is written each time a message is issued by a VTAM module. It 
can be used to find the originator of a message and to see whether it was solicited 
or unsolicited. 


MSG trace entries are generated for a// messages, even those that are suppressed 
by message-flooding prevention (described in VTAM Messages and Codes) or by 
the MODIFY SUPP Command (described in VTAM Operation). MSG trace entries thus 
provide information that may be missing from the operator's console. 


TSO/VTAM messages (beginning with IKT) are not traced in the viT. See 
Chapter 4, “mvs Procedures for TSO/VTAM Problems” for TSO/VTAM information. 


O/O/O;O/O/O/O;O;O/O;O;O;O;O;O;O; LI L|L{ LPL LpapAylpLpayljlydyiyi 
O}142/3)4/ 5/6) 7B) 9jJAIBICIDIE| FIO} 1) 2)3)4)5)6)7/8)9 ABC DIE] F 


MSG [I S| SAVE MSG ID|RETURN |MODULE | DESTINATION 
D ADDRESS | ID 
r| ADDRESS} ‘USS ' 


Byte (hex) Contents 
00-03 Record ID: C'MSG’ 
04 ID 
¢ For Mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For VM, machine and task ID 
e For VSE, task !D 
05-06 Zero 


07 ‘s' or ‘u’. If this field is ‘s', the message was solicited (in direct 
response to a VTAM commana). If this field is ‘u’, the message was 
unsolicited. 

08 —0B Address of the issuer of the macro 

OC — OF Message Ip or ‘uss’. If USS, the message ID appears in the variable text 
field. 

10-13 Save area address 

14-17 Issuing module ID (4th, 5th, 7th, and 8th characters of the issuing 


module name) 
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18—-1F Destination. If byte 07 is ‘s’, then this field contains one of the fol- 
lowing: 


e ‘sySTEMxx’, where xx is the ID of the system console. This is the 
name of the program operator application that requested the 
message. 


¢ ‘NLDM’, when the message is destined for NLDM. 


e ‘unc’, when the message is to be sent to the system console using 
routing codes, instead of to one console in particular. 


If byte 07 is ‘u’, this field is zero. 
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Message Sent Record (Part 1) 
Entry: 
ViT Option: 
Event: 


vIT Processing Module: 
Control is Returned to: 


Applies to: 


MSGS 


MSGS 

MSG 

Message Sent Record (Part 1) 
ISTRACOT 

ISTCFCWM or ISTLUCRC 

MVS, VM, VSE 


This trace record is written each time an attempt is made to send a message to its 


destination. 


It can be used to correlate the console sheet with the internal trace. 


The destination may indicate that the message was sent to a system console (via a 
WTO macro) or to a program operator application, such as the NetView program 
(via a RCVCMD macro). 


0}010/0;0)0; 0/0 

Q0}1)2)3)4)5)6]7 

MSGS n° DESTINATION 
D 


0/0)0)0/0)0/0/0 
B)/O{A|B/CIDIE 


FIRST 12 CHARACTERS 
OF MESSAGE TEXT 


MESSAGE 
HEADER 


Byte (hex) Contents 


00-03 
04 


05 — 07 
08 — OF 


10-13 


14-1F 
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Record 10: C'MSGs’ 
iD 

e For mvs, address space ID 

(or zero if address space ID is greater than X'FF') 

e For VM, machine and task ID 

e For VSE, task !D 
Zero 
Destination. If ‘SYSTEMxx’, the message was sent to system console 
'Xx', Via a WTO macro. If an application name, the message was sent to 
a program operator application, via a RCVCMD macro. 
Message header (in hex). If destination is ‘SySTEMxx’, this will be the 
WPL header. If destination is a program operator application, this will 
be a program operator header. 
First 12 characters of the message text. If the message text is longer 
than 12 characters, it will continue in mMSsG2. 
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TPMSG or CPMSG or Message Sent Record (Part 2) 


434 VTAM Diagnosis 


Entry: MSG2 

vIT Option: MSG 

Event: TPMSG Macro or CPMSG Macro, or Message Sent Record 
(Part 2) 

viT Processing Module: ISTRACOT 

Applies to: MVS, VM, VSE 


This trace record contains variable data for the MSG entry, or more message text 
for the MSGS entry. This is a continuation of the MSG or MSGS trace record. 


O/OJO/O/O/OlO;O;O;O;O;O;O; Li LLILILiLydy@p@plilpiydyaylyl 
QO}1)2)3)4) 5/6) 7B 9jJAIBCIDI EFF IO; 1) 2) 3/4) 5] 6/7; 8/9 A|BIC|DIE]F 


MSG2 VARIABLE DATA or MORE MESSAGE TEXT 


Byte (hex) Contents 

00-03 Record ID: C'MSG2’ 

04—1F Variable data (if this is a continuation of a MSG entry), or more 
message text (if this is a continuation of a MSGS entry). 
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LU 6.2 Message Unit (Part 1) 


MU1 
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Entry: MU1 

ViT Option: APPC 

Event: LU 6.2 message unit (Part 1) 
viT Processing Module: ISTRACAC 


Modules invoking the INTRACE macro causing the 
record to be produced 
MVS (V3R2), VM (V3R2), VSE (V3R2) 


Control is Returned to: 
Applies to: 


This trace record shows information about an LU6.2 message unit. It is generated 
whenever a message unit is queued to another component. 


OO;O;O/O/OO;O/O/O;O/O;O;O;O;O; AT] LiLpLPLiLilplplyay_ylplyiyl 
O}1)2)3)4) 5/6} 718) 9AIBICIDIE}|F/O}1)2)3)/4)5}6)7)8)9)A|BIC|DIE\F 


MU1 IT}MU ID|MU HS ID |CORR R AMU SENSE 
D ADDRESS ADDRESS|E FLAGS 
i 
C 
D 


DATA 
Byte (hex) Contents 


or 0 


00-03 Record ID: C'Mu1 
04 ID 
e For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For vM, machine and task ID 
e For vSE, task ID 
05 —07 Message unit ID 


X'010101' (END_CONVERSATION) 
X'010201' (PS_COPR_FMH5_RCVD) 
X'010302' (CONFIRMED) 
X'010303' (REQUEST TO SEND) 
X'010304' (SEND_DATA_RECORD) 
X'010305' (SEND_ERROR) 
X'010306' (SEND PACING RSP) 
X'010501' (ALLOCATE _RCB) 
X'010502' (DEALLOCATE_RCB) 
X'010503' (GET_SESSION) 
X'010504' (UNBIND_ PROTOCOL ERROR) 
X'020101' (CNOS_ABORT) 
X'020201' (CNOS_CLEANUP) 


X'020501' (CNOS_ COMPLETE) 
X'020502' (CHANGE_SESSIONS) 
X'030103' (REQUEST TO SEND) 
X'030104' (RECEIVE DATA) 
X'030105' (RECEIVE_ERROR) 


X'030106' 
X'030107' 
X'030108 ' 


PACING RSP_RCVD) 
RSP_TO_REQUEST_TO_SEND) 


( 
( 
( 
( 
( 
( 
X'030102' (CONFIRMED) 
( 
( 
( 
( 
( 
(INITIAL_PACING_COUNT) 
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08-0B 
OC - OF 
10-13 
14 

15-17 
18-1B 
1C-14F 
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X'030109' (DEALLOCATE_ABEND_REJECTED) 
X'030401' (ABORT_HS) 

X'030501' (ATTACH_HEADER) 

X'030502' (FREE_SESSION) 

X'030503' (BID) 

X'030504' (BID_RSP) 

X'030505' (BIS_RQ) 

X'030506' (BIS_REPLY) 

X'030507' (RTR_RQ) 

X'030508' (RTR_RSP) 

X'040501' (SESSION_ACTIVATED) 
X'040502' (SESSION_DEACTIVATED) 
X'040503' (ACTIVATE_SESSION_RSP) 
X'040504' (CTERM_DEACTIVATE_SESSION) 
X'040505' (LNS_LRM_FREE_AMU) 
X'050101' (RCB_ALLOCATED) 

X'050103' (SESSION_ALLOCATED) 
X'050104' (ATTACH_RECEIVED) 
X'050105' (CONVERSATION_FAILURE) 
X'050301' (HS_PS_CONNECTED) 
X'050302' (YIELD_SESSION) 

X'050303' (BID_WITHOUT_ATTACH) 
X'050304' (BiD_RSP) 

X'050305' (BIS_RQ) 

X'050306' (BIiS_REPLY) 

X'050307' (RTR_RQ) 

X'050308' (RTR_RSP) 

X'050401' (ACTIVATE_SESSION) 
X'050402' (DEACTIVATE_SESSION) 
Message unit address 

Half session !0 

Address of correlator 

LU 6.2 message unit return code (AMURETCD) 
Zero 

LU 6.2 message unit flags (AMUFLAGS) 
LU 6.2 message unit sense data (AMUSENSE) or 0 
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LU 6.2 Message Unit (Part 2) 


Entry: MU2 

vit Option: APPC 

Event: LU 6.2 message unit (Part 2) 

vit Processing Module: ISTRACAC 

Applies to: mvs (V3R2), vm (V3R2), vse (V3R2) 


This trace record is a continuation of the mui trace record. 


4H alee dui AREA 4b 
di ib dab slatalslely Aare 


MU ID|DATA SES|SES; CONV |VARI- 
ADDRESS|LENGTH |ADDRESS|CNT}LIM 4 ABLE 
OVERLAY 
FIELD 


Byte (hex) Contents 
00-03 Record 1p: C'MU2’ 
04 Zero 
05-07 Message unit ID (see “LU 6.2 Message Unit (Part 1)” on page 435) 
08—0OB Data address or 0 
OC — OF Data length or 0 
10-13 Resource allocation block address or 0 
14-15 For Mu ID X'020502': Session count 
For all other MUIDS: Zero 
16-17 For MU ID X'020502': Session limit 
For all other MU IDs: Zero 
18-—1B For MU IDs associated with an active conversation (X'010201', 
X'030108', X'050301'): Conversation ID 
For all other MU IDS: Zero 
1C—1F Variable overlay field 


For MU IDs X'010201', X'010501', and X'050101': Task ib 
For MU ID X'020201': COPR control block address 


For MU ID X'020502': 
1C-1D CNOS delta 
1E-—1F zero 


For MU IDs X'030106' and X'030108': Pacing count increment 


For Mu ips X'030501', X'030503', X'030504', and X'030507': RPH 
address for inbound half session 


For all other MUIDS: Zero 
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LU 6.2 Message Unit (Part 3) 


Entry: MU3 

viT Option: APPC 

Event: LU 6.2 message unit (Part 3) 

vIT Processing Module: ISTRACAC 

Applies to: MVS (V3R2), VM (V3R2), VSE (V3R2) 


This trace record is a continuation of the mu2 trace record. It is generated for only 
those message units which contain Mu IDs X'010201', X'010501', X'020502', 


X'040501', and X'050401'. 

OOPO/O;O/O/OfO;O/O;O;O/O;O;O;O; LIL LIL)LpAPAPA;LpA;ApApAy@{ afl 
0}1)2}3/4)5)6}7)8)9{AIBiC|DIE}FIO}1)}2)3)4)5)6)7)8/9)A|BiC|DE|F 
m3 fo|mu ID} MODE NAME or Q| LOCAL LU NAME |REMOTE LU NAME 


Byte (hex) Contents 

00-03 Record 1p: C'Mu3’ 

04 Zero 

05-07 Message unit ID (see “LU 6.2 Message Unit (Part 1)” on page 435) 
08 — OF For MU IDs X'010501', X'020502', X'040501', and X'050401': Mode 


name 

For all other Mu IDs: Zero 
10-17 Local logica! unit name 
18—1F Remote logical unit name 
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Negative Response to a PIU Request (Part 1) 


Entry: NRSP 

VIT Option: PIU 

Event: Negative response to a PiU request (Part 1) 
vit Processing Module: ISTRACOT 

Control is Returned to: ISTTSCGR 

Applies to: VSE (V3R2),MVS,VM 


This trace record is written when VTAM’S TSC response generating routine, ISTTSCGR, 
generates a negative response to a Piu request. Since this entry is associated with 
an event failure, it is treated as an exception condition and is always traced, 
regardless of the vit options specified, if the viT is active. 


leelel lai fotalelelsielaaieiclelet: 
AHH EJF/Oj;1)2 


NRSP | IT/C)F{O}TSCB 20 BYTES OF PIU 
D}B}L} |ADDRESS 
IVA 
D}G 
S 


Byte (hex) Contents 
00-03 Record 1p: C'NRSP’ 
04 ID 
¢ For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For vm, machine and task !D 
¢ For VSE, task ID 


05 Control block ID 
06 Flag field (TSCFLAG1) 
07 Zero 


08—-0OB Address of TSCB 
OC —1F First 20 characters of the Piu. 
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Negative Response to a PIU Request (Part 2) 
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Entry: NRS2 

viT Option: PIU 

Event: Negative response to a PIU request (Part 2) 
viT Processing Module: ISTRACOT 

Applies to: VSE (V3R2), MVS, VM 


This trace record is a continuation of the NRsP entry. It contains 24 more characters 
of the Plu. 


] 


1 
0 


1 


1 


1 
2 


ale 
3 


] 
/ 


1} 1 


1 
8}9 


0}0}0/0/0/0)0/0/0)0 1 l 
6/7 8/9 A|BIC|DIEIF A\B 


‘lel 


24 MORE CHARACTERS OF THE PIU 


Byte (hex) Contents 

00-03 Record iD: C'NRS2’ 

04—1B 24 more characters of the Plu 
1C—1F Return address of the issuer 
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Operator Command (Part 1) 


Entry: OPER 

vIT Option: MSG 

Event: Operator Command 

vIT Processing Module: ISTRACOT 

Control is Returned to: ISTLUCMD 
MVS ISTCFF3D, ISTINCF9 
VM ISTINVOO 

Applies to: vVSE (V3R2), MVS, VM 


This trace record is written each time a VTAM command is issued at the operator 
console. This can help you match the console log to a surge of activity shown in 
the vit. This trace record is also useful when the console log is unavailable. Addi- 
tionally, it provides a record of POA commands that have been issued. These do 
not appear on the console log. 


The variable data in bytes 08— 1F is the command text, with minor modifications. If 
this data is longer than 24 characters, it will continue in oPE2. The command 
always appears in abbreviated form: 


DISPLAY command 

MODIFY command 

VARY command 

HALT command 

Unknown command passed to VTAM 


NyN < 710 


NET and procname are excluded from the command text. Since the VTAM internal 
trace is not active when VTAM is started, the START command is not traced. 


OO;O;O/O;O;O/O/O/O;/O/O/O;O;O;O;LILJLIL)LiLiLpljlydy2yi}ijijiyi 
O}1;2/3/4/ 5/6) 7/8) 9/A/BICIDJE] F/O} 1} 2)3)4)/5}6) 7/8) 9/A|Bi CDI EF 


OPER j|IIF FIRST 24 CHARACTERS OF OPERATOR COMMAND 
DIL 
A 
G 


Byte (hex) Contents 
00 —03 Record !0: C'OPER’ 
04 ID 
¢ For mvs, address space !D 
(or zero if address space ID is greater than X'FF') 
e For vm, machine and task ID 
e For VSE, task ID 


05 Flag byte 
e If bitO = 1, a POA command was issued. 
e {f bitO = 0, it was not a POA command. 
06 — 07 Zero 
O8—1F First 24 characters of the operator command 
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Operator Command (Part 2) 


Entry: OPE2 

VIT Option: MSG 

Event: Operator Command (Part 2) 
viT Processing Module: ISTRACOT 

Applies to: VSE (V3R2), MVS, VM 


This trace record is a continuation of the OPER entry. It contains up to 28 more 
characters of the operator command. 


O;O/O;O/O;O;/O;O;O;O;O/O;O;TILIL~A;PLiLpLpAplPLpApyls{ lpi ayl 
3/}4)5/6}7{8{9{A;BiC|DIE;FIO}1)2)3)4)/5)6] 7; 8/9 /A|BIC|DIE}F 


UP TO 28 MORE CHARACTERS OF THE OPERATOR COMMAND 


Byte (hex) Contents 
00—03 Record ID: C'OPE2’ 
04—1F Up to 28 more characters of the operator command 
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vm vse Packet Interface (V3R1.2 and Later) 


Entry: VM vse PIC 

VIT Option: ClO 

Event: Start 1/0 

viT Processing Module: ISTRACTR (SNAP trace recording routine) 
Control is Returned to: ISTAPCES 

Applies to: VM VSE (V3R1.2 and later) 


This trace record provides information about internal control flows of the telecom- 
munications subsystem or communication adapter. 


QO;,O;O;O;O/O/O;O;O;O/O;O;O;Of; LIL LiL LyLp@pLiilplylidyly yl 
213/41 5/6] 7/8/9jAIBICIDIE; FIO; 1) 2; 3/4] 5) 6} 7) 8)9{A|BIC|DIE;F 


PIC INTERNAL TRACE DATA 


Byte (hex) Contents 
00-02 Record ID: C'PIC' 
03—1F Internal trace data 
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PIU 


PIU Record (Part 1) 
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Entry: PIU 

VIT Option: PIU 

Event: Piu Record (Part 1) 

vIT Processing Module: ISTRACOT 

Control is Returned to: ISTTSCPR, ISTTSCLS, ISTTSCRI, ISTTSCSC, ISTTSCSR, ISTTSCWS, 
ISTTSCPD, ISTTSCLE, ISTTSCXS (Or ISTINCF1 and INTINCS1 for 
RUPE) 

Applies to: MVS, VM, VSE 


This trace record provides information about external and internal FID4 Plus. 


For most Plus, only the first 48 bytes are traced (a 26-byte TH, a 3-byte RH, and up to 
the first 19 bytes of RU). However, certain classes of Pius, such as session control 
RUS and VTAM Rus, are traced in their entirety. 


If the control block is a RUPE, the TH is reconstructed by the internal trace using 
what information is available. For TScB entries, the piu is recorded as is. 


If the PiU is a response with sense data, this entry will be generated whether the Piu 
option is in effect or not. It is treated as an exception condition, and consequently, 


is traced, if the vit is active. 
He OIOOLLILILILILILILIL Ly Ly lylyis1yiil 
a CIDIEJFIOI1L(2131/4/5/6)7/8/9 AIBICIDIE]F 
TSCB 20 BYTES OF PIU 

or 


RUPE 
ADDRESS 


Byte (hex) Contents 
00-03 Record 1D: C'piu’ 
04 ID 
e For Mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For vM, machine and task !D 
e For VSE, task ID 


05 Control block ip: X'54' =RuPE, X'99' =TSCB 

06 Flags (TSCFLAG1, or zero if control block is a RUPE) 
O07 Zero 

08 — 0B TSCB Or RUPE address (see byte 5) 


OC —-1F 20 bytes of PiU 
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PIU Record (Part 2) 


Entry: PIU2 

vIT Option: PIU 

Event: PiU Record (Part 2) 
vit Processing Module: ISTRACOT 

Applies to: MVS, VM, VSE 


This trace record contains 28 more bytes of an FiD4 Plu. It is a continuation of PIU 
Record (Part 1). 


vit will generate as many as 32 Piu2 records for Pius which are formatted and 


contain session control RUS or RUs to or from the SSCP or PUS. The number of 
records generated depends on the data count field in the TH. 


O/O/O/O/O;O;O;O;O;O;O;O;O; LIT) APLpAPLILpAplpLydfljiyijiyi 
3/4) 51/6/7/8/9/A|BIC|DIE|F/O}1;2/3)4)5/6)7)8/9/A/BIC|DIE|F 


PIU2 28 MORE BYTES OF PIU 


Byte (hex) Contents 
00-03 Record 10: C'piu2’ (an extension to a PIU record) 
04—1F Up to 28 more bytes of the FID4 Piu (padded at right with zeros) 
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vm vse Packet (V3R1.2 and Later) 


Entry: VM VSEPKT 

VIT Option: ClO 

Event: Start 1/0 

viT Processing Module: ISTRACTR (SNAP trace recording routine) 
Control is Returned to: ISTAPCES 

Applies to: VM VSE(V3R1.2 and later) 


This trace entry provides information about the packets received at (PKTI) or sent 
from (PKTO) the x.25 port. 


A PKTI trace record is written whenever the buffer control channel program com- 
pletes with packets received. 


A PKTO trace record is written whenever a packet is transferred to the telecommu- 
nications subsystem or communication adapter by inserting it into the buffer 
control channel program. 


Note: If the packet is longer than 20 bytes (including packet header), up to 27 bytes 
of data are traced in an extension identified by the PKTx trace record. 


OVO/O/O/OO;O;O;O/O/O/O;O;O;O;O;LIL{/LiLpLiLyLiLplya@f~lplydy_yqy. 
O}1}2)3)4)5]6|7/8)9/A|BIC]DIE} FIO} 1)2)3)4)/5/6) 7/8, 9; ABI CDI E,F 


PKTI j|Iy) CUA FIRST 20 BYTES OF THE PACKET 
PKTO |D 


Byte (hex) Contents 

00-03 Record ID: 
C‘PKT!’ for inbound packet 
C'PKTO' for outbound packet 


=nn wo 
<x OO Zr 
ZzrHAH@D 2 re 


04 Machine and task ID 

05-07 Channel device name in EBCpic (either a CuA or device number) 
08 Packet finite state machine (PFSM) 

09 Index to slot that packet arrived on 


OA—OB Packet length 
OC —1F First 20 bytes of the packet 
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vm vse Packet Extension (V3R1.2 and Later) 


Entry: VM VSE PKTX 

viT Option: ClO 

Event: Start 1/0 

vIT Processing Module: ISTRACTR (SNAP trace recording routine) 
Control is Returned to: ISTAPCES 

Applies to: vM vse (V3R1.2 and later) 


This trace record is a continuation of the PKTi or PKTO trace record. 
OVO/O/O/O/O/OOJOOJO;O/O;O OO; LI LIL LILILi LILI Lili Li lyli1y1iii 
OIL 21/3/4516 17/8/9IAIBICIDIE/FIO]1/213)4/5/617/8I9/AIBICIDIEIF 


PKTX ADDITIONAL BYTES OF PACKET 
D 


(if needed) 
Byte (hex) Contents 
00-03 Record !0: C'PKTX’ 
04 Machine and task ID 
05—1F Up to 27 additional bytes of the packet. 
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POST 


TPPOST 
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Entry: POST 

viT Option: PSS 

Event: TPPOST Macro 
viT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCTP 
Applies to: MVS, VM, VSE 


This trace record identifies the RPH that is being posted for restart after a TPWAIT 
macro. Usually the PosT entry is followed sometime later by a RESM entry. 
However, when a TPPOST precedes the TPWAIT, the TPWAIT returns to the caller imme- 
diately without waiting. Then POST is not followed by RESM. 


O;O/O;O/O/O;O;O;O/O;O;O/OO;O;O; LAT DTiLiLpap ly lydylylplydyayl 
0}1)2)3/4)5/ 6) 7/8) 9; A|BIC|DJE} FIO} 1)2)3/4)5;6}7/8)9j A} BI CIDE] F 


POST {I P |PST PAB RETURN |WORK DVT RPH 
D A | ADDRESS] ADDRESS | ADDRESS | ELEMENT | ADDRESS | ADDRESS 


Byte (hex) Contents 

00 —03 Record 1D: C'POST’ 

04 ID 
e For mvs, address space ID 

(or zero if address space ID is greater than X'FF') 

¢ For vM, machine and task ID 
e For VSE, task ID 

05 Zero 

06 — 07 PAB Offset 

08 —0B PST address 

OC — OF PAB address 


1 CO WW 


10-13 Address of the issuer of the TPPOST macro 
14-17 Work element address (from RPHWEA) 
18-—1B PAB DVT address 


1C—-1F Address of the RPH being posted 
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mvs vM Queued REQSTORE 


Entry: MVS VM QREQ 

VIT Option: SMS 

Event: Queued REQSTORE 
vit Processing Module: ISTRACSM 

Control is Returned to: ISTORMBQ 

Applies to: MVS, VM 


This trace record identifies the REQSTORE requests that were waiting for a buffer, 
and which are now Satisfied. 


OO;O/O;OO/O;O/O/O;O;O;O;O;O;O;L{Ljrylylyl 
QO}1)2/3/4/516|7/8/9|A|BIC|DIE| F/O} 1) 243/445 


QREQ |I/C PST BUFFER NUM RPH 
D/B ADDRESS | ADDRESS BUF ADDRESS 
I 
D 


Byte (hex) Contents 
00-03 Record 1D: C'QREQ’ 
04 ID 
* For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
¢ For vM, machine and task ID 
05 Control block ID index value 
06 — 07 Zero 
08 — 0B PST address 
OC — OF Address of buffer obtained 
10-13 Zero 


1415 Number of buffers requested 
16—-1B Zero 
IG=1F RPH address 
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450 _sVTAM Diagnosis 


Entry: QUE 

viT Option: PSS 

Event: TPQUE Macro (Part 1) 

vit Processing Module: ISTRACPS 

Control is Returned to: ISTAPCTQ 

Applies to: mvs (V3R1.1 and V3R1.2), vm (V3R1.1 and V3R1.2), vse 


(V3R1 and V3R1.2) 


This trace record shows a work element queued to a PAB to allow another VTAM 
routine to do further processing with the work element. This entry may be followed 
shortly by a DISP entry, representing the Pss dispatch of this PAB. However, if the 
PAB is already running, it might not be dispatched again. In this case, no DisP entry 
follows the TPQUE. 


bp aie HEA nee ‘ale Alalale 
dH ees iHBb slalals sltlalo Sele 


I}C| P |PST RPH 

DiB} A |ADDRESS ad ELEMENT as ADDRESS 
I! B ADDRESS or 0 
D 


Byte (hex) Contents 
00-03 Record ID: C‘QUE’ 
04 ID 

e For mvs, address space !D 

(or zero if address space ID is greater than X'FF') 

e For VM, machine and task ID 

e For VSE, task ID 
05 Control block iD of work element (Control block IDs are shown in 

Appendix E, “Storage and Control Block ID Codes” on page 657.) 

06 — 07 PAB Offset 


08 — 0B Address of PST associated with PAB 

OC — OF PAB address 

10-13 Address of work element to be queued 

14-17 PAB Chain field 

18-—1B Module name abbreviation (bytes 4, 5, 7, and 8 of the module name), 


or PAB DVT address (high order bit of X'18' = 0). 


The module name might be unavailable if the PAB being scheduled is 
associated with a different address space than the current one. 
1C=1r RPH address or zero 
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TPQUE (Part 2, for V3R1, V3R1.1, and V3R1.2) 


Entry: QUE2 

viT Option: PSS 

Event: TPQUE Macro (Part 2) 

vit Processing Module: ISTRACPS 

Applies to: MVS (V3R1.1 and V3R1.2), VM (V3R1.1 and V3R1.2), VSE 


(V3R1 and V3R1.2) 


This trace record is a continuation of the QUE trace entry. 


O/OOOO;O/O/O;O/O;O;O/O;O;O;O;L) A A;APLPL]Tp~Lplydpipapaylyqyil 
O11)2)3)4)5/6)/7 18/9 A; BIC DIE} FIO; 1)2)3)4)5/6)7)8, 9; A; Bi C| DIE} F 


QUE2 |RETURN PAB EXTENSION or 0 
ADDRESS 


Byte (hex) Contents 
00-03 Record 1D: C‘QUE2’ 


> »TmmyN 
ro 2z U0 }Y 


04-07 Address of the issuer of the TPQUE macro 

08 PAB scheduling flags (PABFLAGS) 

09 TPQUE options (See field APNFLGS in control block ISTAPNOP, VTAM Data 
Areas) 

OA — OF Zero 

10—1F PAB extension (PABXTNSN) if this is an extended PAB. 
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QUE (V3R2) 


TPQUE (V3R2) 
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Entry: QUE 

VIT Option: PSS 

Event: TPQUE Macro 

viT Processing Module: ISTRACPS 

Control is Returned to: ISTAPCTQ 

Applies to: MVS (V3R2), vm (V3R2), vSE (V3R2) 


This trace record shows a work element queued to a PAB to allow another VTAM 
routine to do further processing with the work element. This entry may be followed 
shortly by a DISP entry, representing the Pss dispatch of this PAB. However, if the 
PAB is already running, it might not be dispatched again. In this case, no DisP entry 


Tidjlplylyaylidydydydyiylii 
3/4) 5/6)7/8)9/A|BIC {DIE} F 
RPH 


follows the TPQUE. 


ADDRESS 
ADDRESS|or DVT jor 0 
ADDRESS 


Byte (hex) Contents 
00-02 Record ID: C‘QUE’ 
03 Control block 1D of work element (Control block IDs are shown in 
Appendix E, “Storage and Control Block ID Codes” on page 657.) 

04 ID 

e For mvs, address space ID 

(or zero if address space ID is greater than X'FF') 
e For VM, machine and task ID 
e For VSE, task ID 


05 Flag field (PABFLAGS) 

06 TPQUE options (See field APNFLGS in control block iSTAPNOP in VTAM 
Data Areas.) 

07 Flag field 


e Bit 0 is the PAB work element queue gate bit (PABWEQG). 

e Bits 1, 2, and 3 are reserved by IBM. 

e Bit 4 is the PAB change bit (PABCHNG). PABCHNG=0 If the PAB was not 
previously scheduled to run. PABCHNG = 1 if the PAB was previously 
scheduled to run. 

e Bits 5, 6, and 7 are reserved by IBM. 

08—0OB PST address 
OC — OF PAB address 


10-13 Address of the issuer of the macro 
14-17 Address of work element to be queued 
18-1B Module name abbreviation (bytes 4, 5, 7, and 8 of the module name), 


or PAB DVT address (high order bit of X'18' = O). 


The module name might be unavailable if the PAB being scheduled is 
associated with a different address space than the current one. 
1C—1F RPH address or zero 
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TPQUE NONE 


Entry: QUEN 

VIT Option: PSS 

Event: TPQUE NONE Macro 
viT Processing Module: ISTRACPS 

Control is Returned to: ISTAPCTQ 

Applies to: MVS, VM, VSE 


This trace record shows a work element queued to any control block (not just a 
PAB) to allow another VTAM routine to further process the work element. 


SH Abe ee nA eu Nalelo 
de allele dH slalals ane ‘lelela 


QUEUE |RETURN |WORK 
siete ADDRESS | ADDRESS | ELEMENT 
ADDRESS 


eine 
or 0 


Byte (hex) Contents 
00-03 Record ID: C‘QUEN’ 
04 ID 

e For mvs, address space ID 

(or zero if address space ID is greater than X'FF') 

e For vM, machine and task ID 

e For VSE, task 1D 
05 Control block ID of work element (Control block IDs are shown in 

Appendix E, “Storage and Control Block ID Codes” on page 657.) 

06 —07 Zero 


08 —0B Address of PST or zero 

OC — OF Address of the control block field to which the work element is queued 
10-13 Address of the issuer of the TPQUE NONE macro 

14-17 Address of work element to be queued 

18-—1B Zero 

1C—1F RPH address or zero 
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RCE (V3R2) 
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Entry: RCE 

viT Option: NRM 

Event: RCE Macro 

vit Processing Module: ISTRACNR 

Control is Returned to: ISTRACSC 

Applies to: MVS (V3R2), VM (V3R2), VSE (V3R2) 


This trace record contains information about an RCEADD, RCECHG, RCEDEL, or RCEFIND 


macroinstruction issued by a VTAM module. 
LiLiLiLylilylylsasyi_syiyiyl 
314/5/6/7/8I9AIBICIDIE|F 


0}0)0)0/0)/0/0;0;0)0;0)0/0;/0/0;0)1 
0}1)2/3)4)5)6)71/8)9;A|BIC|DiE| FIO 


T}R| TIM KEY VALUE RETURN }OUT1 or|OUT2 or| DATA 
DIC}Y)0 

PD 

EVE 


ADDRESS} NEW ADDRESS 
Byte (hex) Contents 


00-03 Record 1D: C‘RCEA’, C’RCEC’, C'RCED’, C'RCEF’ 
04 ID 
e For MVS, address space ID 
(or zero if address space ID is greater than X'FF') 
e For VM, machine and task ID 
e For VSE, task ID 


1}1 
1\2 


05 Return code 

06 Type of RCE entry 

07 Mode of RCE entry (in hex) 
01 = Base entity mode 02= Reference entity mode 

08 — OF Key value (base entity name, base index, or reference index, 
depending on mode) 

10-13 Address of the issuer of the macro 

14-17 For RCEADD, RCEDEL, and RCEFIND: Value in RCEPOUT1 
For RCECHG: First half of new table name 

18-—1B For RCEADD, RCEDEL, and RCEFIND: Value in RCEPOUT2 


For RCECHG: Second half of new table name 
1C—1F Data address 
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RPL Exit 
Entry: 
VIT Option: 
Event: 


viT Processing Module: 
Control is Returned to: 


Applies to: 


RE 


RE 

API 

RPL Exit 

ISTRACAP 

ISTAPCSX Or ISTAPCUE 
MVS, VM, VSE 


This trace record contains RPL information passed from VTAM to the application 
program. If the return code or feedback is non-zero, this entry will be generated 
whether the Ap! option is in effect or not. It is usually treated as an exception con- 
dition, and consequently, is traced, if the viT is active. 


see V7TAM Programming for a description of RPL return codes. 


OO;O/OOO/O/O;O;O;O;O;O;Of;OjO; Li A;A;LPLJL)L)Lj@plyljljij1yiyi 
O}1)2)314/5) 6) 78/9 AI BIC DIE F/O) 1)2/314)5]6)7/8) 9; A; BIC| DIE] F 


RE |RIE|IIR| FIFI] RPL EXIT RPL RPL CID RPL 
E|}X/D}T|D}D}ADDRESS|ADDRESS| AREA RLEN or 0 FDBK2 
QiT; |N{BIB 
TID] |Ci213 
YS D 
Byte (hex) Contents 
00-01 Record ID: C'RE’ 
02 RPL request type (RPLREQ) 
X'15' SETLOGON 
X'16' SIMLOGON 
X'17' OPNDST 
X'1A' INQUIRE 
X'1B'  INTRPRET 
X'1F' CLSDST 
X'22' SEND 
X'23' RECEIVE 
X'24' RESETSR 
X'25' SESSIONC 
X'27' SENDCMD 
X'28' RCVCMD 
X'29' REQSESS 
X'2A' OPNSEC 
X'2C' TERMSESS 
03 Exit definition (RPLEXTDS) 
04 ID 
e For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
¢ For vm, machine and task ID | 
¢ For vSE, task ID 
05 RPLRTNCD (See VIAM Programming) 
06 RPLFDB2 (See VITAM Programming) 
07 RPLFDB3 (See VIAM Programming, under INQUIRE macro with 
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08-0B 
0C — OF 
10-13 
14-17 
18—1B 
1C—1F 


“Restricted Materials of IBM” 
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RPL address 

Exit address 

RPL data area pointer (RPLAREA) 

Record length (RPLRLEN) 

CID from NIB or from RPL (RPLARG) or zero 

Second RPL feedback area - Sense code (RPLFDBK2) 
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RELSTORE 
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Entry: RELS 

viT Option: SMS 

Event: RELSTORE Macro 
viT Processing Module: ISTRACSM 
Control is Returned to: ISTORMBD 
Applies to: MVS, VM, VSE 


This trace record provides the status of each RELSTORE request issued by VTAM com- 
ponents to release fixed-length buffers to one of the predefined buffer pools. 


RELSTORE is the complement of REQSTORE. Storage obtained by REQSTORE must be 
released by RELSTORE. However, since more than one buffer may be obtained and 
released at a time, there may not be a RELS for every REQS, and there may not bea 
REQS for each RELS. Use the “next buffer address” in RELS and the “number of 
buffers” in REQS as Clues. 


OVO/O/O/O/O/O;OO;OO/O;O;O;O;O;L LiL; LiL~LpLpLiLyTyaplpdylydyl 
O}1;2;3/4/5/6)7/B/9AIBIC{DIE;FIO;1)2)3)4)/ 5) 6} 7) 8) 9A BIC{DIE|F 


RELS |I{C}P Ij}PST BUFFER {RETURN |NEXT REG 1 |CALLER 
D}B}O D|ADDRESS | ADDRESS | ADDRESS | BUFFER OF 
T}0 ADDRESS UTILITY 
DIL or 0 or 0 


Byte (hex) Contents 
00-03 Record Ip: C'RELS' 
04 ID 
e For MvS, address space ID 
(or zero if address space ID is greater than X'FF') 
¢ For vm, machine and task ID 
¢ For VSE, task ID 


05 For MVS and VM, control block ID index value 
For VSE, zero 
06 — 07 For MVS and VM, zero 


For VSE, buffer pool 1D 
08 —0OB PST address 
OC — OF Address of buffer to be released 


10—13 Address of the issuer of the RELSTORE macro 

14-17 Pointer to the next buffer to be released if more than one buffer to be 
RELSTOREG; otherwise, zero 

18—1B Register 1 (normally RPH address) 

1G =—1F Caller of utility routine, or zero 


e¢ For mvs, address of the utility’s caller, if the RELSTORE macro was 
issued from a utility routine. Otherwise, zero if the macro was 
issued directly by the caller without a utility routine. (See bytes 
10-13 for the address of the issuer of the RELSTORE macro.) 


¢ For VM and VSE, zero. 
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REQSTORE 
Entry: REQS 
viT Option: SMS 
Event: REQSTORE Macro 
viT Processing Module: ISTRACSM 
Control is Returned to: ISTORMBA 
Applies to: MVS, VM, VSE 


This trace record provides the status of each REQSTORE request issued by VTAM 
components to obtain fixed-length buffers from one of the predefined buffer pools. 
The storage obtained by REQSTORE is released by RELSTORE. 


If this entry is associated with an event failure, that is, the return code is non-zero, 
this entry will be generated whether the sms option is in effect or not. It is treated 
as an exception condition, and consequently, is traced, if the viT is active. 


0}0/0)0 HH a He Aelia a Alalalo 
Pe sb oat AARRHE ‘Nelela 


REQS 4p BUFFER | RETURN | NUM REG 1 {RETURN 
ae ADDRESS | ADDRESS “ CODE 


Byte (hex) Contents 
00-03 Record iD: C'REQS' 
04 ID 
e For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For vM, machine and task ID 
¢ For VSE, task ID 


Oo es © 


05 For MVS and vM, control block ID index value 
For VSE, zero 
06 —07 For MVS and vM, zero 
For vSE, buffer pool 1p 
08— 0B Pointer to the PST, or zero 
OC —OF Address of buffer obtained, or zero if buffer not obtained 
10-13 Address of the issuer of the REQSTORE macro 
14-15 Number of buffers requested 
16-17 Zero 
18—1B Register 1 (normally RPH address) 


1C—1F Return code 
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Resume from TPWAIT 


Entry: RESM 

VIT Option: PSS 

Event: Resume from TPWAIT 
vIT Processing Module: ISTRACPS 

Control is Returned to: ISTAPCPD 

Applies to: MVS, VM, VSE 


This trace record gives information about which VTAM process is about to be redis- 
patched after a TPWa!T. A RESM entry follows a POST, although not every POST has a 
RESM. Usually the Post entry is followed sometime later by a RESM entry. However, 
when a TPPOST precedes the TPWwAIT, the TPWAIT returns to the caller immediately 
without waiting. Then Post is not followed by RESM. Use the RPH address to find the 
Original DiISP entry, which may have occurred quite some time earlier. 


Hnb ae ae ‘sles ABE alate 
Ap alelel 1M “HPP HE ‘lelela 


RESM {IjC]} P {PST RPH 
D A |ADDRESS a ELEMENT | ELEMENT ae ADDRESS 
ADDRESS | QUEUE 


Byte (hex) Contents 
00-03 Record 10: C'RESM’ 
04 ID 
e For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For VM, machine and task Id 
e For vse, task ID 


Oo re & 


05 Control block !D of work element (Control block ips are shown in 
Appendix E, “Storage and Control Block ID Codes” on page 657.) 
06 —07 PAB offset 


08 —0B PST address 
OC — OF PAB address 


10-13 Work element address 
14-17 PAB work element queue 
18-—1B PAB DVT address 

1C—1F RPH address 
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TPSCHED (Part 1, for V3R1, V3R1.1, and V3R1.2) 


Entry: SCHD 

VIT Option: PSS 

Event: TPSCHED Macro (Part 1) 

ViIT Processing Module: ISTRACPS 

Control is Returned to: ISTAPCTS 

Applies to: MVS (V3R1.1 and V3R1.2), VM(V3R1.1 and V3R1.2), VSE 


(V3R1 and V3R1.2) 


This trace record shows the schedule of a PAB to be dispatched and the last work 
element, if any, that was queued to the PAB. This entry should be followed shortly 
by a DISP entry, representing the Pss dispatch of this PAB. 


O/OPO;O/O/O;O/O/O/O;O;O;O;O;O;/O;LIL)LpLLpLidj@plydidplply iit y. 
O}1)2)3)4)5/6)7(8/9 ABI C DIE; F/O}1)2) 3/4) 5) 6/71 8/9}A\BIC| DIE] F 


SCHD {I}C} P | PST PAB MODULE |RPH 
D}B} A |ADDRESS|ADDRESS|ELEMENT|}CHAIN |NAME ADDRESS 
I or DVT 
D | ADDRESS 


Byte (hex) Contents 
00-03 Record 10: C‘SCHD' 
04 ID 
¢ For MvSs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For vM, machine and task ID 
e For VSE, task ID 
05 For mvs and VSE, zero 
For vM, control block ID. (Control block IDs are shown in 
Appendix E, “Storage and Control Block ID Codes” on page 657.) 
06 — 07 PAB Offset 


nn CO W 


08 —OB PST address associated with PAB 

OC —OF PAB address 

10-13 PAB work element queue 

14-17 PAB chain field 

18—1B Module name abbreviation (bytes 4, 5, 7, and 8 of the module name), 


Or PAB DVT address (high order bit of X'18' = 0). 


The module name might be unavailable if the PAB being scheduled is 
associated with a different address space than the current one. 
1C—1F RPH address or zero 
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SCH2 (V3R1, V3R1.1, and V3R1.2) 


TPSCHED (Part 2, for V3R1, V3R1.1, and V3R1.2) 


Entry: SCH2 

viT Option: PSS 

Event: TPSCHED Macro (Part 2) 

viT Processing Module: ISTRACPS 

Applies to: Mvs (V3R1.1 and V3R1.2), vm (V3R1.1 and V3R1.2), vse 


(V3R1 and V3R1.2) 


This trace record is a continuation of the SCHD entry. 
LJLilylylylydydplylylyiyiyiyi 
1)/2/3/4/5)6/7\8)9/A/BICIDIE\F 


RETURN PAB EXTENSION or 0 


Byte (hex) 
00-03 
04—07 

08 

09 


0A — OF 
10—1F 


ADDRESS 


Contents 

Record 10: C'SCH2’ 

Address of the issuer of the TPQUE macro 

Zero 

TPSCHED options (See field APNFLGS in control block ISTAPNOP in VTAM 
Data Areas) 

Zero 

PAB extension (PABXTNSN) if this is an extended PAB. 
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TPSCHED (V3R2) 


Entry: SCHD 

vit Option: PSS 

Event: TPSCHED Macro 

vit Processing Module: ISTRACPS 

Control is Returned to: ISTAPCTS 

Applies to: mvs (V3R2), vm (V3R2), vse (V3R2) 


This trace record shows the schedule of a PAB to be dispatched and the last work 
element, if any, that was queued to the PAB. This entry should be followed shortly 


by a pisP entry, representing the Pss dispatch of this PAB. 
RPH 
ADDRESS 


SCHD FIN|G|PST RETURN |WORK MODULE 
D}L}0}A|ADDRESS adi ADDRESS | ELEMENT |} NAME 
A|P}T or DVT 
Gi IE ADDRESS 


Byte (hex) Contents 
00-03 Record ID: C'SCHD' 
04 ID 
¢ For MvSs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For VM, machine and task ID 
¢ For VSE, task ID 


05 Flag field (PABFLAGS) 

06 TPSCHED options (See field APNFLGS in control block ISTAPNOP in VTAM 
Data Areas.) 

07 Flag field 


e Bit 0 is the PAB work element queue gate bit (PABWEQG). 

e Bits 1, 2, and 3 are reserved by IBM. 

e Bit 4 is the PAB Change bit (PABCHNG). PABCHNG =0 if the PAB was not 
previously scheduled to run. PABCHNG = 1 if the PAB was previously 
scheduled to run. 


e Bits 5,6, and 7 are reserved by IBM. 


08 — 0B PST address associated with PAB 

OC —OF PAB address 

10-13 Address of the issuer of the TPSCHED macro 

14-17 PAB work element queue 

18—1B Module name abbreviation (bytes 4, 5, 7, and 8 of the module name), 
or PAB DVT address (high order bit of X'18' = Q). 


The module name might be unavailable if the PAB being scheduled is 
associated with a different address space than the current one. 
1C—-1F RPH address 
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mvs Start I/O (Part 1) 


Entry: mvs SIO 

vit Option: ClO 

Event: START 1/0 

vit Processing Module: ISTRACCI 

Control is Returned to: ISTTSCIO Or ISTTSCLC 
Applies to: MVS 


e The siol trace record is written when a START I/O SVC is issued for a channel- 
attached communication controller or SNA cluster controller. 


e The SIOL trace record is written when a START I/O SVC is issued for a channel- 
attached non-SNA device. 


e The siox trace record is written when a START I/O SVC is issued for a channel-to- 
channel attachment. 


The sio trace record will eventually be followed by an INT entry. Use the cua field 
to match the correct entries. See VTAM Data Areas for a description of the NCB 
l 


fields. 
O/O;OLO;OO;O;O; DL ALP LiLpaylplyLydylyljqy. 
B/IA|BICIDIE}F{Oj1;2)314)/5)6)7)8) 9; A} By CID 


CUA |NCB FLAG CAW CCW or 
ADDRESS} BYTES DEVICE- 
DEPENDENT 
INFORMATION 


I 
D 


Tore OO = 


On OO = 


CUA INCB FLAG CAW | CCW or OUTPUT 
ADDRESS| BYTES CONTROL AREA 
(STATUS 
INFORMATION) 


Byte (hex) Contents 

00-03 Record Ip: 
C'siol’ for ICNCB 
C'sIOL’ for LDNCB 
C'siox’ for XCNCB 


04 Address space |D (or zero if address space ID is greater than X'FF') 
05 For siol and SIOL, link station state (NCBLNKST) 
For SiOx, station state (XCNSSFSM) 
06 —07 Module Ip (last two characters of TSc module name) 
08 For sioli and SIOL, Write Start command 
For SiOx, zero. 
09—0B Channel device name in escoic (either a CUA or device number) 
OC — OF NCB address 
10-13 Flag bytes (NCBFLAGS) 
14-17 Virtual channel address word (NCBCAW) 
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18—1F if link is active: 
e For siol and SIOL, device-dependent information: 
Byte (hex) Contents 
18-—1B Virtual buffer address of the first Write Ccw or zero 
1C Read Start command code or zero 
1D—1F Zero 


e For siox, output control area (status information). 


if link is not active, first channel command word (ccw). 
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mvs Start I/O (Part 2) 


Entry: MVS S102 
viT Option: ClO 
Event: START I/O 
viT Processing Module: ISTRACCI 
Applies to: MVS 


This trace record is a continuation of the sio entry. 


O/O/O/O/O/O/O/O;O;O;O;O;O;O;O;O; LITT; A;A;ApI}L~LpL~lyq_pa@ypayi 
QO} 1}2)3/4)/5)6)7/8/9/AIBIC DIE} FIO} 1)2)3)4)5;6)7|8)9j/A| BIC DIE 


ST02 


1 


Byte (hex) Contents 

00-03 Record 1p: C'sio2’ 

04-07 Virtual buffer address of the first Read ccw, or zero. 
08 —1F Zero, or station state (XCNSSFSM) for SIOXx. 
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vm SIO 


vm Start I/O (Part 1) 
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Entry: vm SIO 

vit Option: (eile) 

Event: START I/O 

viT Processing Module: ISTRACCI 

Control is Returned to: ISTTSCIO or ISTTSCLC 
Applies to: VM 


This trace record is written when a START I/O Svc is issued for a channel-attached 
communication controller or SNA cluster controller. It will eventually be followed by 
an INT entry. Use the Cua field to match the correct entries. See VTAM Data Areas 
for a description of the NcB fields. 

: a BEE 

8 DIE 


allele 1 HP se ‘i 
ae eal “Hn 6|7 


1}1 


1 
A|B 


1 
9 C 


SIOB |I}L) M NCB FLAG 
or DIF} 0 ADDRESS} BYTES 
SIOH S| D 
M; I 
D 


AN AK 2a me 
0 VU O = 


NCB FLAG 

ADDRESS| BYTES 

NCB FLAG CCW or OUTPUT 

ADDRESS| BYTES CONTROL AREA 
(STATUS 
INFORMATION) 


Byte (hex) Contents 
00-03 Record ID: 
C'sios’ for BSCLB 
C'SIOH’ for HALCB 
C'siol’ for ICNCB 
C'SIOL’ for LONCB 
C'siox’ for XCNCB 
04 Machine and task ID 
05 For SiOB or SIOH, link finite state machine (LFSM) 
For SiO! or SIOL, link station state (NCBLNKST) 
For siox, station state (XCNSSFSM) 


mH PHAM 
OrVTW OF 


06 —07 Module iD (last two characters of Tsc module name) 

08 Zero 

09—0B Channel device name in Escpic (either a CUA or device number) 
OC — OF NCB address 

10-13 Flag bytes (NCBFLAGS) 

14-17 Virtual channel address word (NCBCAW) 
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18—1F For SIOB, SIOH, SIOI, SIOL: Zero 
For siox: 
¢ If link is active, output contro! area (status information) 
e If link is not active, first channel command word (ccw) 
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vm vse Start I/O (V3R1.2 and Later) 


Entry: vm VSE SIO 

ViT Option: ClO 

Event: Start 1/0 

VIT Processing Module: ISTRAC6T 

Control is Returned to: ISTTSC6F 

Applies to: vm (V3R1.2 and later), vse (V3R2) 


This trace record is created when a Start 1/0 Svc is issued for the Token-Ring Sub- 
system. Channel programs started for the subsystem do not always complete. If 
the channel program completes, it is eventually followed by an int entry. Use the 
CUA field to match the correct entries. 


OOO/O/O/O;O;O;O;O/O;O;O;O;O;O;D LIT T{1i1j1j1zi1 
O}1)2)3/4)5/6/7 18/9) A|B/C|DIE} F/O} 1)2)3)4)5/6)7/8 


STOP {IC CUA {NCB CAW 
D}P ADDRESS 
F 
S 
M 


Byte (hex) Contents 
00-03 Record 1D: C'SIOP’ 


moon 


M 
0 
D 
I 
D 


Pod4iYP Oo Uv 


04 Machine and task !D 
05 Channel program FSM 
00 # Reset 


01 Sense ID 

02 = Interrupt port 

03 Control port 

04 Running 

05 Sense 

06 Orderly halt (HLTC) 
07 Termination 

08 Shutdown 


06 — 07 Module 1b (last 2 characters of Tsc module name) 
08 Zero 
09—OB Channel device name in EBCDIC (either a CUA or device number) 
OC —OF NCB address 
10 Port state (PDATA) 
0O Reset 
O01 Halt 


02 + Halt complete 

03 Sense ID 

04 Sense iD complete 
05 Interrupt pending 


06 Active 
O07 Sense 
11 Port type (PDATA) 
00 =—iInterrupt 
01 Control 
02 Inbound 


03 Outbound 
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12-13 Zero 

14-17 Channel address word 

18 Channel-command code for the first ccw 
C4 Sense control unit state 
CB Set CETI mode on 
E4 Sense ip 

19—1F Zero 
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vm S102 “Restricted Materials of IBM” 
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vm Start I/O (Part 2) 


Entry: vm SIO2 
viT Option: ClO 
Event: START 1/0 
vit Processing Module: ISTRACCI 
Applies to: VM 


This trace record is a continuation of the sio entry. 


CR RCRMCHECHECHECHECHECHECHECHECHECHECHICHECHECI DGD UG UG Rama nm 
0}1)2)3/41/5/6;7/8)/9/A|BiC}DJE|F{O}1)2/3/4/5)6 


S102 DEVICE-DEPENDENT INFORMATION 
or Q 


Byte (hex) Contents 
00-03 Record 1b: C'sio2’ 


04 ERACT 

05 Temporary error counter (TECT) 

06 ERCOD 

07 Return code 

08—17 Device-dependent information shown below, or zero 


18—1F Zero 


For sotc links (NCBTYPE = 09): 


08 Index to current PUT 

09 Station flags 

0A Station finite state machine 

OB Connection finite state machine 
OC-17 Release-dependent information: 


For VTAM V3A1.1: 


OC Connection manager flags 

OD-—17 First 11 bytes of ccw command code 
For VTAM V3R1.2 and later: 

0C-0D Connection manager flags 

OE-—17 First 10 bytes of ccw command code 


For BSC links (NCBTYPE = 0A): 


08 Current channel program finite state machine (BSCCCFSM) 

09 Original channel program finite state machine (BSCOCFSM) 

0A Previous channel program finite state machine (BSCPCFSM) 

OB Original failing channel program finite state machine (BSCFCFSM) 
0C First selection character (BSCSEL1) 

OD First device address (BSCDEV1) 

OE Index of BPL entry for which input data was received (BSCPESV) 
OF Device address from which input data was received (BSCDEVSV) 
10 Index for last station for which there was output data (BSCISOD) 
11 First response byte (BSCRSPA1) 
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12 Second response byte (BSCRSPA2) 

13 Last block type received (BSCLBR) 

14 Current acknowledgment (BSCALTAK) 
15 Error retry count (BSCRCNT) 

16 Connection manager flags (BSCCMiIO) 
17 BSC flags (BSCFLAGS) 
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vse SIO “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


vse Start I/O (Part 1) 


Entry: VSESIO 

viT Option: ClO 

Event: START I/O 

vit Processing Module: ISTRACCI 

Control is Returned to: ISTTSCIO or ISTTSCLC 
Applies to: VSE 


This trace record is written when a START I/O SVC is issued for a channel-attached 
communication controller or SNA cluster controller. It will eventually be followed by 
an INT entry. Use the cua field to match the correct entries. See VTAM Data Areas 
for a description of the NcB fields. 


O/O;/OO;O;O;O/O;O;OO;TpLj lili 1j1jayi 
516)7/8/9}/A}BiC|DIE} FIO] 1)2/3)4)5}6)7 


CUA |NCB FLAG CAW 
ADDRESS| BYTES 

CUA |NCB FLAG CAW 
ADDRESS| BYTES 


Byte (hex) Contents 

00-03 Record ID: 
C'sioB’ for BSCLB 
C'SIOH’ for HALCB 
C‘siol’ for ICNCB 
C'SIOL’ for LDNCB 


(Ta) 

——{ 

(on) 

= 
= nn TO 
DTH UO = 


Ce) 

mH 

) 

rr 
aN AK =a TT 
Or VO 


04 Task ID 

05 Link finite state machine (LFSM), or link station state (NCBLNKST) 
06 — 07 Module ID (last two characters of TSC module name) 

08 Zero 

09 —0B Channel device name in EBCDIC (either a CUA or device number) 
OC — OF NCB address 

10-13 Flag bytes (NCBFLAGS) 

14-17 Virtual channel address word (NCBCAW) 


18—1F zero 
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vse Start I/O (Part 2) 


vse $102 


Entry: vVSESIO2 
VIT Option: ClO 
Event: START I/O 
viT Processing Module: ISTRACCI 
Applies to: VSE 


This trace record is a continuation of the sio entry. 


S102 


Byte (hex) 
00-03 

04 

05 

06 

07 

08 — 17 
18—1F 


O/O/O;O;O;O/O;O;O;O;O/O;O;O;O;O; Ls Lily1i1jaj1 
0)1)2}/3)}4)5)/6)7)8/9;A|B/C|D/E}FIO}1)2)3)4)5)6 


DEVICE-DEPENDENT INFORMATION 
or 0 


Contents 

Record ID: C's!o2’ 

ERACT 

Temporary error counter (TECT) 

ERCOD 

Return code 

Device-dependent information shown below, or zero 
Zero 


For soic links (NCBTYPE =09): 


08 
09 
OA 
OB 
OC-17 


Index to current PUT 

Station flags 

Station finite state machine 
Connection finite state machine 
Release-dependent information: 


For VTAM V3R1: 


OC Connection manager flags 

OD—-17 First 11 bytes of ccw command code 
For VTAM V3R1.2 and later: 

0C-0D Connection manager flags 

OE—17 First 10 bytes of ccw command code 


For BSc links (NCBTYPE =0A): 


08 
09 
OA 
OB 
0C 
OD 
OE 
OF 
10 
11 
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Current channel program finite state machine (BSCCCFSM) 
Original channel program finite state machine (BSCOCFSM) 
Previous channel program finite state machine (BSCPCFSM) 
Original failing channel program finite state machine (BSCFCFSM) 
First selection character (BSCSEL1) 

First device address (BSCDEV1) 

Index of BPL entry for which input data was received (BSCPESV) 
Device address from which input data was received (BSCDEVSv) 
Index for last station for which there was output data (BSCISOD) 
First response byte (BSCRSPA1) 
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vse SIO2 
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12 
13 
14 
15 
16 
17 


“Restricted Materials of IBM” 
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Second response byte (BSCRSPA2) 
Last block type received (BSCLBR) 
Current acknowledgment (BSCALTAK) 
Error retry count (BSCRCNT) 
Connection manager flags (BSCCMiIO) 
BSC flags (BSCFLAGS) 
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vm vse Start 1/O (V3R1.2 and Later) 


Entry: VM VsE SIO 

vIT Option: ClO 

Event: Start 1/0 

vIT Processing Module: ISTRACTR (SNAP trace recording routine) 
Control is Returned to: ISTAPCES 

Applies to: vM VSE (V3R1.2 and later) 


This trace record provides information about Start 1/o at the channel interface for 
an X.25 port. 


The telecommunications subsystem or communication adapter uses two channel 
programs: acontrol link channel program and a buffer pool channel program. An 
SIO entry is built for the control channel program whenever it is started, and also 
when the buffer pool channel program is started. This channel program is an 
endless channel program and terminates only in case of error or when the adapter 


stops. 
O;O;O;O;O;O;LT Lj LiLpL LyLyLilyLylj1jiyliiy1 
AJBICIDIE;FIOI1/2);3) 4/5) 6)7/8/9/A|BICIDIE|F 


0/0}0/0;0/0)0)0/0/0 
0) 1;2/3)4)5}6)7)/8/9 
DUMP OF WRITE CONTROL AND READ CONTROL 


SIO |TiI} CUA }P 
Y|D DATA AREAS 
P 
E 


Byte (hex) Contents 

00 — 02 Record 1p: C'sio' 

03 Type: 
OC = Control link channet program 
OD = Buffer pool channel program 


04 Machine and task ID 

05 —07 Channel device name in Escoic (either a CUA or device number) 
08 Packet finite state machine (PFSM) 

09 Zero 

OA—1F Dump of Write Control and Read Control data areas 
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“ivS SRB Dispatch 


Entry: vivS SRBD 
viT Option: PSS 

Event: SRB Dispatch 
viIT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCAD 
Applies to: MVS 


This trace record provides information when Pss is dispatched under an SRB. 


Note: In addition to specifying the Pss option, you must also set the RACON bits to 
B'1’ for this trace record to be created. 


O/O;O;O/O/O/O;O/O;O;O/O;O;O/O;O;T APL LiLiLyLplplpljaplylylyiaqyl 
Q/1)2)3)4)5/6}7/8/9)A| By CDE] F)O}1)2)3)4)5)6)7)8) 9) A; BIC} DIE} F 


SRBD {I PST PST TCB F 
D ADDRESS | ASYNC ASYNC |ADDRESS} L 
N-DISP G 
QUEUE ] 
(ANDSP) 


Byte (hex) Contents 

00-03 Record 1D: C'SRBD' 

04 Address space ID (or zero if address space !D is greater than X'FF') 
05 —07 Zero 

08 — OB PST address 


OC — OF PST asynchronous dispatchable queue address (PSTADSP) 
10-13 PST asynchronous flag field (PSTIAF) 

14-17 PST asynchronous nondispatchable queue address (PSTANDSP) 
18-—1B TCB address (PSTTCBA) 

10—-—1D PST flags (PSTFLG1) 


1E—1F Zero 
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mvs SRB Exit 
Entry: mvs SRBX 
VIT Option: PSS 
Event: SRB Exit 
viT Processing Module: ISTRACPS 
Control is Returned to: ISTAPCSX 
Applies to: MVS 


This trace record provides information when Pss exits an SRB. 


Note: In addition to specifying the PSs option, you must also set the RACON bits to 
B'1' for this trace record to be created. 


O/O/O/O/H/O;O;O;O/O;O;O;O;O;O;Of;Li APA LiDpLyLplf{Lydpa_ylylydyayd 
O11} 2; 3/4) 56/718 9{AL BIC DIE} FIO} 1)2)3)4)5)6)7/8/9 A,B) C| DIE} F 


SRBX {I PST PST 
D ADDRESS | ASYNC 
DISP ADDRESS | ADDRESS 
QUEUE 
(ADSP) 


Byte (hex) Contents 

00-03 Record 1D: C'SRBX'’ 

04 Address space ID (or zero if address space ID is greater than X'FF') 
05 —07 Zero 

08 — 0B PST address 


OC —OF PST asynchronous dispatchable queue address (PSTADSP) 
10-13 PST asynchronous flag field (PSTIAF) 
14-17 New ASCB address 


18-—1B Old ascsB address 
1C—1F Zero 
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SRTCHG (V3R2 only), SRTADD, SRTDEL, SRTFIND 


478 VTAM Diagnosis 


Entry: SRT 

viT Option: NRM 

Event: SRTADD, SRTCHG, SRTDEL, SRTFIND Macros 

viT Processing Module: ISTRACNR 

Control is Returned to: ISTNRCSA for SRTADD; ISTNRCSD for SRTCHG, SRTDEL, and 
SRTFIND 

Applies to: MVS, VM, VSE 


This trace record contains information about a SRTADD, SRTCHG, SRTDEL, Or SRTFIND 
macroinstruction issued by a VTAM module. 


Note: SRTCHG is new for VTAM V3R2. 


HASH NAME RETURN | SRT NETWORK ID 
(NAME or ADDRESS} ENTRY 

NETWORK ADDRESS 

ADDRESS) 


T 
Y 
P 
E 


Byte (hex) Contents 
00-03 Record ID: C'sSRTA’, C'srAtc’, C'SRTD’, or C'SRTF' 
04 ID 
e For MVS, address space ID 
(or zero if address space ID is greater than X'FF') 
e For vM, machine and task ID 
e For VSE, task ID 


05 Return code 

06 Zero 

07 Type of SRT entry 

08 — OF Network name or network address (padded on left with zeros) passed 
to the hashing algorithm 

10-13 Address of the issuer of the SRTADD, SRTCHG, SRTDEL, Or SRTFIND macroin- 
struction 

14-17 Address of SRT entry for the resource 

18—1F Network ip of the resource 
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USER Exit (DFASY or RESP) 


Entry: UE 

VIT Option: API 

Event: User Exit 
viT Processing Module: ISTRACAP 
Control is Returned to: ISTAPCUE 
Applies to: MNS Poly VSL 


This trace record identifies the exit dispatched and data passed back to the user 
application program. 


If this entry is associated with an event failure, that is, the return code is non-zero, 
this entry will be generated whether the AP! option is in effect or not. It is treated 


as an exception condition, and consequently, is traced, if the viT is active. 


For DFASY and RESP exits (type codes = 07 and 08), the user exit trace record has 
the following format: 


O,OVO/OLO/O/O;OLOO;O/O;O/O/O;O;L LIL LpdplpLidylpdylplydyayiyd 
O;1/213/4; 5/6; 7/B/9AIB/C DIE; FO; 142) 3); 4,516) 7; 8/9 A] By CDI EVF 


UE ICVE}I RPL EXIT RPL RPL CID RPL 
0} X|D ADDRESS | ADDRESS} AREA RLEN or 0 FDBK2 
_ 1D 
E 


Byte (hex) Contents 


NO Axx mM 
ONO 2H Dw 
Nou mn 
wWwwWoTn 


00-01 Record 1p: C'UE’ 

02 Exit type code (X'7' =DFASY, X'8' = RESP) 
03 Exit definition (RPLEXTDS) 

04 ID 


e For mvs, address space ID 

(or zero if address space ID is greater than X'FF') 
e For vM, machine and task ID 
e For VSE, task ID 


05 RPLRTNCD (See VTAM Programming) 
06 RPLFDB2 (See VIAM Programming) 
07 RPLFDB3 (See VITAM Programming) 


08 —0B RPL address 
OC — OF Exit address 


10-13 RPL data area pointer (RPLAREA) or zero 

14-17 Record Jength (RPLRLEN) 

18—1B CID from NIB Or RPL (RPLARG) or zero 

AG =1F Second RPL feedback area — Sense code (RPLFDBK2) 
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USER Exit (Part 1, not DFASY or RESP) 


The user exit trace record (Not OFASY or RESP, Part 1) has the following format: 


ne HE — 
{A ela ep 


EXIT-TYPE PRIMARY SECONDARY 
DEPENDENT (APPL) LU NAME 
__ INFORMATION LU NAME or 0 


Byte (hex) Contents 
00-03 Record 1p: C‘UE1' 
04 Ts) 

¢ For mvs, address space iD 

(or zero if address space ID is greater than X'FF') 

¢ For vM, machine and task ID 

¢ For VSE, task !D 
05 Exit type code (see Figure 69 on page 481) 
06 — 07 Zero 
08 — OF Exit-type-dependent information (see Figure 69 on page 481) 
10-17 Primary (application program) logical unit name 
18-—1F Secondary logical unit name, or zero if this is a TPEND exit (see 

Figure 69 on page 481). 
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i 

Type | Exit 

Code | Type Contents 
os ScP (NO) 08-08 | RP conal tae RPLENTOGAPLENTSC) 
P]Jon=or [sessonsaraners 

SCIP (STSN) RPL control flags (RPLCNTDC, RPLCNTSC) 

Se Su (= 
——Joe=00 Tarussay 
ion Caen 
eS onen o0=08 [RPL cone tage @PLENTOG) 
Peer foo 
ce [acon [0e=06 | togondeiaeng 
ca 
a 
Ca 


ec C= 

08—0B | Reason code 

a 
a0 [eno | o0=08 [Resa ase 


Figure 69. Exit-Type — Dependent Information for a UE1 Entry 
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USER Exit (Part 2, not DFASY or RESP) 
The user exit trace record (Not OFASY or RESP, Part 2) has the foliowing format: 


rb bt bb 
Q/1)2)3)4/516 


EXIT 
ADDRESS 


Byte (hex) Contents 

00-03 Record 10: C‘UE2’ 
04-07 Exit address 

08 — 1F Zero 
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TPUNLOCK All 


Entry: ULKA 

VIT Option: LOCK 

Event: TPUNLOCK All Macro 
vit Processing Module: ISTRACLK 

Control is Returned to: ISTAPC39 

Applies to: MVS, VM, VSE 


This trace record contains information about a routine releasing all locks it cur- 


rently holds. 
0/0) 0 O;O;O;O;O;O} 1} 1} 141 
314) 5 AIBICIDIE;FIO}1) 2/3 
ULKA RETURN 
a ne ADDRESS ADDRESS 


Byte (hex) Contents 
00-03 Record ID: C‘ULKA’ 
04 ID 
e For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For vM, machine and task ID 
e For VSE, task ID 
05 —07 Zero 
08 — 0B PST address 


OC — OF CRA lock account word (CRALKACT; see step 11 on page 41) 
10-13 Address of the issuer of the TPUNLOCK macro 

14-—1B Zero 

1G—AF RPH address 
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UNLK 


TPUNLOCK 
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Entry: 
viT Option: 
Event: 


viT Processing Module: 
Control is Returned to: 


Applies to: 
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UNLK 

LOCK 

TPUNLOCK Macro 
ISTRACLK 
ISTAPC33 
MVS,.VM.VSE 


This trace record contains information for a routine releasing a lock. It is the com- 
plement of a LKEX or LKSH entry. 


Byte (hex) Contents 


ae 


00-03 Record 1D: C‘UNLK’ 


04 ID 


e For mvs, address space ID 

(or zero if address space ID is greater than X'FF') 
e For vm, machine and task ID 
e For VSE, task ID 


05 Zero 

06 — 07 Level of lock to be released 

08 — 0B Address of lock to be released 

OC — OF CRA lock account word (CRALKACT; see step 11 on page 41) 
10-13 Address of the issuer of the TPUNLOCK macro 


14-—1B Lockword 


1C —1F RPH address 
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User Post 
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Entry: UP 

vit Option: API 

Event: User Post 

vIT Processing Module: ISTRACAP 

Control is Returned to: ISTAICPT Or ISTAPCSX 


Applies to: MVS, VM, VSE 


This trace record provides the RPL information that VTAM passes to the application 
program. The RPL information and the API TPIO request record (Ain or 1On) show 
VTAM activity for a given API request. 


See VITAM Programming for a description of the RPL return codes. 
lf this entry is associated with an event failure, that is, the return code is non-zero, 


this entry will be generated whether the api option is in effect or not. It is treated 
aS an exception condition. and consequently, is traced, if the vit is active. 


rod ares lal AAP Eta NAR 
6}718 tele leah ANP sl als sae 


RPL RPL ag RPL 
AREA RLEN FDBK2 


Byte (hex) Contents 

00-01 Record 1D: C'uP’ 

02 RPL request type (RPLREQ) 
X'15' SETLOGON 
X'16' SIMLOGON 


X'17' OPNDST 
X'1A' INQUIRE 
X'1B' INTRPRET 
X'1F' CLSDST 
X'22' SEND 
X'23' RECEIVE 
X'24' RESETSR 
X'25' SESSIONC 
X'27' SENDCMD 
X'28' RCVCMD 
X'29' REQSESS 
X'2A' OPNSEC 
X'2C' TERMSESS 
03 Exit definition (RPLEXTDS) 
04 ID 
e For mvs, address space ID 
(or zero if address space 1D is greater than X'FF') 
¢ For vm, machine and task ID 
e For vSE, task 1D 
05 RPLRTNCD (See VIAM Programming) 
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07 


08-08 
0C — OF 
10-13 
14-17 
18—1B 
1C—1F 
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RPLFOB2 (See VTAM Programming) 

RPLFDB3 (See V7TAM Programming, under INQUIRE macro with 
OPTCD = APPSTAT) | 
RPL address 

Exit address or ECB address | 

RPL data area pointer (RPLAREA) 

Record lfength (RPLRLEN) : 

CID from NIB or from RPL (RPLARG), Or zero 

Second RPL feedback area — Sense code (RPLFDBK2) 
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VTALLOC 
Entry: VTAL 
vIT Option: SMS 
Event: VTALLOC Macro 
viT Processing Module: ISTRACSM 
Control is Returned to: ISTORMAF 
Applies to: yO 


This trace record provides the status of each VTALLOC request issued by VTAM com- 
ponents. 


If this entry is associated with an event failure, that is, the return code is non-zero, 
this entry will be generated whether the sms option is in effect or not. It is treated 
as an exception condition, and consequently, is traced, if the vit is active. 


OO;O/O/O/O;O;O;O;O;O;O;O;O;O;O;LALpAPLLILiLplyLplj@paylylj1iy1 
Ol Li2) 3/4) 5/6} 7/B/9/A;BICIDIE; F/O; 142) 3) 4) 5/617 18/9 /A| BI CDI ELF 


STORAGE] SUBPOOL|RETURN |LENGTH |CALLER | RETURN 
ADDRESS|NUMBER | ADDRESS | OF 
or STORAGE | UTILITY 
POOL ID REQUEST |or 0 


Byte (hex) Contents 
00-03 Record 10: C'vTAL’ 
04 ID 
* For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
¢ For vm, machine and task ID 
e For VSE, task ID | 
05 — 07 Zero 
08—-OB Address of area allocated 
OC —OF For mvs, subpool number of the area allocated 
For vm, buffer pool ID 
For VSE, buffer pool ID 


10-13 Address of the issuer of the VTALLOC macro 
14-17 Length of area allocated 
18—1B Address of issuer of utility routine or 0 


1C—-1F Return code 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 Chapter 8. Using the VTAM Internal Trace 487 


VTFR 


VTFREE 
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Entry: 
viT Option: 
Event: 


vit Processing Module: 
Control is Returned to: 


Applies to: 
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VTFR 

SMS 

VTFREE Macro 
ISTRACSM 
ISTORMAF 
MVS, Vi, VSE 


This trace record provides the status of each VTFREE request issued by VTAM compo- 


nents. 


Byte (hex) Contents 


00 —03 Record 1D: C‘VTFR’ 


04 ID 


e For mvs, address space ID 

(or zero if address space !D is greater than X'FF') 
e For VM, machine and task ID 
e For VSE, task ID 


05-07 Zero 


08 — OB Address of area to be freed 

OC — OF For Mvs, subpool number of the area allocated 
For vM, buffer pool Ip 
For vSE, buffer pool Ib 


10-13 Address of the issuer of the VTFREE macro 
14-17 Length of area to be freed 
18-—1B Address of issuer of utility routine or zero 


1C—-1F Zero 
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TPWAIT 
Entry: WAIT 
VIT Option: PSS 
Event: TPWAIT Macro 
vit Processing Module: ISTRACPS 
Control is Returned to: ISTAPCTW 
Applies to: MVS + VM; VSE 


This trace record identifies an RPH that has been suspended to wait for some VTAM 
resource. This entry might be used with the entry immediately preceding it in the 
table to determine whether the wait is for storage or for a lock. If the preceding 
entry is for a REQSTORE, a waiting-for-storage condition may exist. If the preceding 
entry is for a lock request, the wait cou/d be caused by that request. However, 
VTAM frequently uses a TPWAIT/TPPOST to synchronize intercomponent functions. 
Therefore, the TPWAIT entry does not necessarily identify an unusual condition. 


O;O/O/O/OO;OO/O/O/O;O;O;O;O;O; DTI APL ApLPA;PLiLplpdyljplyi_jdyqyl 
O}1)2)3)4) 5/6} 7/8) 9A B/CIDIE} FIO} 1;2)3)4)5)/6}7/8)9;A|BiC| DIE} F 


WAIT {I PST PAB RETURN |WORK MODULE |RPH 
D ADDRESS | ADDRESS | ADDRESS | ELEMENT | NAME ADDRESS 
or DVT 
ADDRESS 


Byte (hex) Contents 
00-03 Record 1p: C‘waAIT’ 
04 ID 
e For mvs, address space ID 
(or zero if address space ID is greater than X'FF') 
e For vm, machine and task ID 
¢ For VSE, task ID 
05-07 Zero 
08 —- 0B PST address 
OC —OF PAB address 


10-13 Address of the issuer of the TPWAIT macro 

14-17 PAB work element queue 

18-1B Module name abbreviation (bytes 4, 5, 7, and 8 of the name of the next 
module to get control), or PAB DvT address (high order bit of X'18' = 0) 

18-1B PAB DVT address 

1C—1F RPH address 
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nding VTAM Buffer Pools 


avs va General Procedure for Finding VTAM Buffer Pools 


Use the following steps to find VTAM buffer pools and to determine whether any 
have used all their buffers. Figure 70 on page 494 shows the control blocks 
involved in these steps. 


MVS Dumps processed with PRDMP contain all the data necessary to use this proce- 
dure if the operand VTAMMAP is coded in the PRDMP control statements. (See “Mvs 
vM Formatting and Printing Dump Output” on page 279 for more information about 
dumps processed using PRDMP.) 


v™ Dumps processed with PRTDUMP contain all the data necessary to use this proce- 
dure if VTAM control block formatting was requested. (See the VM/SP Interactive 
Problem Control System Guide for more information about dumps processed using 
PRTDUMP.) 


1. Find the atcvt. Its address is at low-storage location mvs X'408' or vm X'200'. 


MVS If this low-address location is not available in a dump, use the pointer in 
the CvT extension (CVTATCVT) to find the AvT. Location X'00' in the AvT points to 
the ATCVT. 


The ATCVT is identified by release level at offset X'00': 
e For VTAM V3R1.1, the identifier is v311 (X'E5F3F1F1'). 
e For VTAM V3R1.2, the identifier is v312 (X'E5F3F1F2'). 
¢ For VTAM V3R2, the identifier is vT32 (X'E5E3F3F2'). 


2. From the Atcvt, find the address of the buffer pool directory (BPDTY) in field 
ATCBPDA. 


3. BPOTY + X'170' is the first buffer pool entry (BPENT). There are 12 BPENTS, one 
for each buffer pool; each is X'10' bytes long and contains the name of a buffer 
pool at offset X'00', and the address of the buffer pool control block (BPcB) at 
offset X'08'. 


4. Find each secs. Each BPCB represents a buffer pool. 
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“ow ATCVT 


storage 
location Je 
hex 408 (MVS) 
or 
hex 200 (VM) ATCBEDA 
BPENT (1 of 12 con- 


secutive entries-ane 
‘or each buffer pool) 


BPDTY 


BPDENTRY 


BPEBPCB 


The BPENT that 
contains the 
cadress of the 
LPQO buffer pool 


BPEBPCB 


BPCBADR1 
BPCBADR2 
BPCBRPHA 


RPH+O 
avenie BPCBRPHS ae 
PX3STADR BPCBBPXB 

eee nice eeEe 
BPCBEXLN 
———- -— CRA+hex 78 


(Expanded 
buffer pool) 


RALKACT 


LPBUF 


Wa 


Note: Not every LPOO buffer 
contains a CRA. 


Figure 70. Buffer Pool Control Block Relationships 
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vvs vw Finding LPBUF 


Use the following steps to find the large pageable buffer pool (LPBUF) in MVS and vM. 
LPBUF is the buffer pool that contains the CRA/RPHS. Figure 70 on page 494 shows 
the control block relationships involved in these steps. 


1. Find the atcvtT. Its address is at low-storage location mvs X'408' orvm X'200'. 


mvs If these locations are not available in a dump, use the pointer in the CvT 
extension (CVTATCVT) to find the AvT. Location X'00' in the AvT points to the 
ATCVT. 


The ATcvt is identified by release level at offset X'00': 
¢ For VTAM V3R1.1, the identifier is v311 (X'E5F3F1F1'). 
¢ For VTAM V3RA1.2, the identifier is v312 (X'E5F3F1F2'). 
¢ For VTAM V3R2, the identifier is vT32 (X'ESE3F3F2'). 


2. From the ATcvtT, find the address of the buffer pool directory (BPDTy) in field 
ATCBPDA. 


3. From the BPoOTY, find the buffer pool control block (BPcB) for the large pageable 
buffer pool (LP00). The BPCB is pointed to by BPDTY + X'1A8'. 


4. The beginning address of the static portion of the LPoo buffer pool is at BPcB + 
X'10'; the end of the static portion is pointed to by BpcB + X'14'. 


5. The first buffer begins at the address found in the BpcB + X'10'. To verify the 
correct buffer pool, offset X'08' in each buffer should have the address of the 
BPCB found in step 3. A buffer is allocated when bit BFPALLOC is ON. 


6. To find the second and third buffers, add X'550' to the address of the previous 
buffer. To find the fourth buffer, skip to the next page boundary (its address is 
a multiple of X'1000'), or add X'560' to the address of the third buffer. Three 
buffers are on each 4K page of storage, followed by 16 unused bytes. 


When you reach the address in BPCB + X'14', you have found the end of the 
LPOO buffer pool. 


7. To find Lpoo buffer pool expansion areas, use the address of the pool extension 
block (PxB) at BPCB + X'90'. If the address is zero, there are no expansions — 
the buffer pool has not been expanded since VTAM was started. In this case, 
skip steps 8 and 9. If there is an address, the buffer pool has been expanded 
dynamically and the expansions need to be examined; continue with the next 
step. 


8. Find the PxB, pointed to by BPpcB + X'90'. The PxB offset X'OC' (PxBSTADR) is 
the beginning of the pool expansion area. If PXBSTADR=0, go to step 9. PxBs are 
not freed by vTAM; only the area containing buffers is freed. The length of the 
expansion area (BPCBEXLN) is found at BPCB + X'pbs. Add the length (BPCBEXLN) 
to the starting address (PXBSTADR) for the end of the expansion area. 


9. Find the next PxB, pointed to by PxB + X'04' (PxBPxB). If PXxBPXB¥#0, proceed as 
in step 8. If PXxBPxXB=0, there are no more expansion areas; the search is com- 
plete. 
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vse General Procedure for Finding VIAM Buffer Pools 


Use the following steps to find the buffer pools and determine whether any have 
used all of their available buffers. Figure 71 on page 497 shows the control blocks 
involved in these steps. 


1. Find the atcvt. Its address is at low-storage location X'10'. 


If this low-address location is not available in a dump, use the pointer at 
SYSCOM + X'60' to find the AvT. Location X'00' in the AvT points to the ATCVT. 


The aTcvtT is identified by release level at offset X'00': 
e For vTAM v3A1, the identifier is v731 (X'E5E3F3F1'). 
e¢ For VTAM V3R1.2, the identifier is v312 (X'E5F3F1F2'). 
e¢ For VTAM V3R2, identifier is vT32 (X'E5E3F3F2'). 


2. The aTcvt is immediately preceded in storage by the buffer pool directory 
(BPDIR) and the fixed-length pool pcBs, which can be identified by the pool ips in 
EBCDIC. (“vse Relative Locations of VTAM Buffer Pools” shows the relative 
locations of the buffer pools.) 


ATCVT + X'3D4' also points to the BPODIR. 
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Hex 304 


Hex 10 t ATCVT 


ATCVT 


BPDIR 


BPOIR 


| PCB for a buffer pool 


Uv 
x< 
@ 
Uv 


BFPFX+0 


ie8) 
Cc 
=~ 
= 
© 
x 

+ 

aA 


Hex 0 Length} Pool ID 
BFPFX+8 | PGE 
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08 Start of pool 


OC End of pool RPH+O0 | Hex 0168 


18] Max no. of 
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Buffer size 


No. of buffers 


: Resume address 
In pool 


RPH+10 


NO 
NO 


28 A First free buffer in poo! 


30 First queued RPH 


XB 


wn 
ie) 
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68) Length of expansion area 


Start of expansion 
area 


—> 


Figure 71. VSE Buffer Poo! Control Block Relationships 
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vse Finding LPBUF 


Use the following steps to find the large pageable buffer pool (LPBUF) in VSE. LPBUF 
is the buffer pool that contains the CRA/RPHS. Figure 71 0n page 497 shows the 
control block relationships involved in these steps. (“vse Relative Locations of 
VTAM Buffer Pools” has more information on the location of VTAM buffer pools in 
VSE.) 


1. Find the atcvt. Its address is at low-storage location X'10'. If this location is 
not available in a dump, use the pointer at SYSCOM + X'60' to find the Avr. 
Location X'00' in the AvT points to the ATCVT. 


The aTcvtT is identified by release level at offset X'00': 
e For VTAM v3A1, the identifier is vT31 (X'E5E3F3F1'). 
¢ For VTAM V3R1.2, the identifier is v312 (X'E5F3F1F2'). 
¢ For VTAM V3R2, the identifier is vT32 (X'E5E3F3F2'). 


2. From the atcvt, find the address of the buffer pool directory (BPDIR) in field 
ATCBPDA (ATCVT + X'3D4'). 


3. From the pointer at BPDIR + X'14', find the buffer pool control block (PCB) for 
the large pageable buffer pool (LP). At offset X'08' in the PcB is the address of 
the start of the LP pool. 


4. To find the next buffer, add X'550' to the address of the buffer prefix (BFPFX) of 
the previous buffer. Continue with this process until the end of the Lp buffer 
pool (at the address in pcB + X'0C'). 


Each buffer (including the prefix) is 1360 (X'550') bytes, and the buffers can 


cross page boundaries. The buffer size is also given in PCBBUFSZ (PCB + 
X'22'). 


The total number of buffers is given in PCBTOTNO (PCB + X'24'). 


5. To find the Lp buffer pool expansion areas, use the address of the pool exten- 
sion block (PxB) at PCB + X'58'. If the address is zero, there are no expan- 
sions — the buffer pool has not been expanded since vTAM was Started. In this 
case, skip steps 6 and 7. If there is an address, the buffer pool has been 
expanded dynamically and the expansions need to be examined; continue with 
the next step. 


6. Find the pxB, pointed to by pcB + X'58'. The PxB offset X'OC (PXBSTADR) is the 
beginning of the pool expansion area. If PXBSTADR=0, go to step 7. PXBS are not 
freed by vTAM; only the area containing buffers is freed. The length of the 
expansion area (PCBEXLN) is found at PcB + X'68'. Add the length (PCBEXLN) to 
the starting address (PXBSTADR) for the end of the expansion area. 


7. Find the next pxB, pointed to by pxB + X'04' (PxBPxB). If PXBPXB#0, proceed as 
in step 6 If PxePxB=0, there are no more expansion areas; the search is com- 
plete. 
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vse Relative Locations of VTAM Buffer Pools 


To find a particular vTAM buffer pool in a vSE system, see the partition map in 
Figure 72 on page 500 and follow these steps: 


1. Find the ATcvT from location X'10', if available, or from offset X'00' in the AvT. 


2. Find the buffer pool directory (BPDIR) from ATcvT + X'3D4', or by subtracting 
X'30' from the ATcvT address. 


3. Find the pool control blocks (PCBs) from the pointers in BPDIR, or by finding the 
EBCDIC pool ID preceding the BPDIR in the storage dump (for fixed-length pools 
only). 


For all buffer pools, the beginning and ending addresses of the initial pool extent 
are contained in the pcs at offsets X'08' and X'0C', respectively. 


For fixed-length pools, the storage area may consist of one or more extents. The 
initial extent allocated when VTAM is started contains the number of buffers indi- 
cated as a start parameter. Additional extents may be allocated if dynamic expan- 
sion is allowed for the poo!. See Network Program Products Planning and VTAM 
Installation and Resource Definition for more information. 


To find the buffers in a fixed-length pool, start with the buffer prefix (BFPFXx) pointed 
to by pcp + X'08'. The buffer prefix (BFPFxX) is the 60-byte area, the third word of 
which points to the pcs. To find other buffers, add to or subtract from the address 
of the current prefix the length of the buffer (contained in the Pca + X'22') plus 60 
(X'3C') for the prefix. If the new location does not contain a BFPFX pointing to the 
same Pcs, you have reached the end of the pool. 


Use the count of buffers at PcB + X'24' to determine whether there are also 
expansion extents. Information about them is found in the PxB, which is chained 
from PcB + X'58'. If that location is not equal to zero, and if the total buffer count 
atpcsB + X'24' is greater than the number of buffers found in the initial extent, 
there are additional buffers pointed to by PxBs. Each Pxs may point to a storage 
area. Examine location X'0C' in the PxB. If that location is not equal to zero, it is 
the beginning address of the extent. The number of buffers is contained at pxB + 
X'16'. Examine the PxB chain pointer at X'04' to find the next Pxs, if any. 
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(may include expansion 
area for other pools) 


Pageable modules 


VTAMRP save area 


Nonpageable modules 


PCBs ond BPDIR 
ATCVT 


VTAMRP TCB 
Nonpageable modules 


Save area VF buffer pool 
LF (1/0) buffer pool 
SF buffer pool 


Nonpageable modules 


Figure 72. VSE Map of the VTAM Partition. 


Ta 


Y 
-< 
" 
oO 
oO 
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Hex 60 | VTAM TID 


—_»> 
5 


_ 


Hex O ATCVT 


18 VTAMRP TIO 


IF | 


Hex 10 ATCVT 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Size nnnk 


Avail. PPAREA 


First LDENT 


ATCVT 


Identifier » 
- BPDIR 
Nonpageable 
8 


A Pageable 
oreo 


* The identifier in ATCVT is VT31 (X'ES5E3F3F1') for VTAM V3R1, V312 (X'E5F3F1F2') for VTAM V3R1.2, 


or VT32 (X'ESE3F3F2') for VTAM V3R2. 
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A) 


Appendix B. Channel Programs 


If you determine that the problem is in an 1/0 sequence, you will need to know the 
normal sequence of !/o ccws within the channel programs for the communication 
controller and channel-attached devices. With a dump, the vit trace with the cio 
option, or a CCWTRACE (if available), you can compare the sequence that happened 
with the expected sequence. When there is a deviation, you can then look at status 
and sense bytes returned from the communication controller or the cluster con- 
troller for information that can help you determine the location of the error condi- 


tion. 
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Channel Programs for Channel-Attached Type 2 and 4 Physical 


Units 


The ICNCB represents type 2 and 4 physical units, and contains addresses and Ccws 
needed for channel programs. Figure 73 shows the IcncB and the location in 


storage of various CCws. 


ICNCB 


NCBCAW = address of 
the first CCW to be 
executed, (either a 
Write Start or a Read 
Start). 


NCB 


= 
O 


© 
oO 


oO 


| 


Write Buffers 


: Write 
bea Break 
CCW 


« (CNWBCCW 


Read Buffers 


The number of read buffers 
equals MAXBFRU. 


Figure 73. Data Areas Used by Channel Programs for Physical Unit Types 2/4 
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Channel Commands 


The following channel commands are used by vTAM to write data to and read data 
from channel-attached type 2 and 4 physical units. 


Command 
Code 
(hex) 

01 

02 


03 


04 


08 


09 


oT 


32 


51 


52 


61 


62 


Command 


Write 


Read 


No-op 


Sense 


TIC (Transfer 
in Channel) 


Write Break 


Write 
Start 0 


Read 
Start 0 


Write 
Start 1 


Read 
Start 1 


Write XID 


Read XID 


Description 


Transfers data from storage in the 
host processor to the i/o device. 


Transfers data from the 1/o device to 
storage in the host processor. 


Causes the channel to respond with 
a channel end and device end. Itis 
the last ccw in a read or write 
chain. 


Transfers 1 or 2 bytes of sense data 
to storage in the host processor. 


Causes the channel to fetch an 
instruction that is not the next 
sequential instruction within the 
channel program sequence. 


Transfers data from storage in the 
host processor to the i/o device and 
indicates that it is the last or only” 
Write command in a chain of Write 
CCWS. 


Begins a write sequence. Alternates 
with Write Start 1. 


Begins a read sequence. Alternates 
with Read Start 1. 


Begins a write sequence. Alternates 
with Write Start 0. 


Begins a read sequence. Alternates 
with Read Start 0. 


The host sends the Write xib 
command to signal the Ncp that a 
channel contact sequence is begin- 
ning and to prepare to receive the 
host's xD. 


The host sends the Read xip 
command to signal the Ncp that the 
host expects to read the NCP's XID. 


Contents of 
Address 
Field 
Output area 


Input area 


Zero 


Address of 
sense data area 


Address of next 
ccw to be exe- 
cuted 


Output area 


Zero 


zero 


zero 


zero 


zero 


Zero 


Figure 74 (Part 1 of 2). VTAM Channel Commands for Type 2 and 4 Physical Units 
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Command Contents of 
Code Address 
(hex) Command Description Field 

A3 Discontact Indicates that the channel is no zero 


longer contacted and the attach- 
ment to the transmission group 
should be broken. Releases the 
Pius on the channel hold and inter- 
mediate queues. 


C3 Contact Establishes contact between the Zero 
host and the ncp. Tells the ncpP to 
use XID information for operations 
with the host. 


93 Restart Causes the controller to reset its Zero 
switches to indicate that the last 
Write Start and Read Start com- 
mands were Write Start 1 and Read 
Start 1 commands. 


Note: Data transfer does not occur on Read Start or Write Start commands. 


Figure 74 (Part 2 of 2). VTAM Channel Commands for Type 2 and 4 Physical Units 


Format of TIC CCWs 


504 = VTAM Diagnosis 


MVS/370 VM VSE The Format 0 TIC Ccw is formatted as follows: 


Byte (hex) Contents 

00 X'08' (TIC identifier) 
01-03 Real address 

04-07 Reserved 


MVS/XA The Format 1 TIC CCW ts formatted as follows: 


Byte (hex) Contents 

00 X'08' (TIC identifier) 
01-03 Zero 

04-07 Real address 


A doubleword Tic extension immediately follows both the Format 0 Tic and the 
Format 1 Tic. VTAM uses the last 4 bytes of the TIC extension to contain the virtual 
address of the next buffer in the chain. 


The Tic extension is formatted as follows: 


Byte (hex) Contents 
08—-0OB Reserved 
OC — OF Virtual address 


For Write buffers, the next to the last physical buffer is handled specially. The real 
address of the TIC points to the last Write Break ccw (ICNWBCCW), but the virtual 
address points to the last Write buffer that contains data (see Figure 75 on 

page 505.) This last buffer is formatted with a Write Break Ccw which is not used, 
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but is copied into icnweccw. If only one buffer exists in the channel program, the 


Write Start Tic is formatted so that the real address points to icnweccw, but the 


virtual address points to the only Write buffer. 


Note that the last Write buffer looks unusual because the Write Break command is 


chained but the next ccw is zero. This Write Break is never physically executed by 
the channel, but the copied version of the ccw (in the Icncs) is executed. 


Write Write Write 
CCW CCW CCW 

1st 

TIC TIC TIC PIU 

“ eS 

Writ Write Write 
Brock Break Break 
CCW CCW CCW 

08 |*ICNWBCCW 7 

TIC TIC PIU 


CD = Chained Data bit on 
CC = Command Chaining bit on 


Figure 75. Write CCWs with Chained Data 
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Channel Program Sequences | | 
The following describes the ccws, in the order that they are executed, in a typical 


Write channel program. — 


506 VTAM Diagnosis 


1. 


ICNWSCCW - Write Start: Each time a Write sequence (the Write Start and all 
associated Write buffers) has completed successfully, the Write Start ccw is 
alternated: The first Write Start operation code is X'31' (Write Start 0), the 
second Write Start code is X'51' (Write Start 1), the third Write Start code is 
X'31', and so on. There is no data transfer associated with this ccw, it is used 
to inform the controller that the previous Write has successfully completed. 


_ ICNWSTIC - Write Start TIC: This ccw is used to chain to the first Write Ccw. 


When the Write channel program consists of a single Write buffer, the real 
address points to icnweccw (the last Write Break). The virtual address of this 
ccw always points to the first Write buffer on a chain or is zero when no Write 
channel program is pending or active for the device. 


. Write or Write Break CCWs Alternating with TICs: Figure 73 on page 502 


shows the write buffers required for writing three Pius, each of which is con- 
tained in a single buffer. Figure 75 on page 505 shows the Write buffers 
required for writing two Pius, when each spans three buffers. 


. ICNWBCCW CCW(3) - Last Write Break: This is the last Write ccw in a channel 


program that is physically executed by the device. The data address points to 
the last Write buffer that contains data. If a read is requested, when this opera- 
tion completes the controller will signal a status modifier (in addition to 
channel end and device end). This causes ICNNPCCW to be skipped by the 
channel. 


. ICNNPCCW - No-Op: if a Write completes and no Read is requested, this is the 


ending ccw in a channel program. If a Read was requested, this Ccw is skipped 
by the channel. The command chain flag will be on in this ccw if a Read was 
previously requested but was not previously initiated, and Read buffers are 
available. 


. ICNSMNOP - Status Modifier No-Op: This ccw receives control after the last 


Write Break, if a Read is signaled. This ccw normally command chains to the 

Read Start so that writing and reading both occur without an intervening inter- 
ruption. If no buffers are available, however, the channel program ends here 

and VTAM recognizes that a Read is required. 


. ICNRSCCW - Read Start: Each time a Read sequence (the Read Start and at 


least one Read) has completed successfully, the Read Start ccw is alternated. 


The first Read Start generation code is X'32' (Read Start 0), the second Read 
Start generation code is X'52' (Read Start 1), the third Read Start generation 
code is X'32', and so on. 


As with the Write Start ccw, there is no data transfer. The ccw alternation is 
used to inform the controller that the previous Read has successfully com- 
pleted. 


When a Write is not required but a Read has been requested by an attention 
status, this is the first ccw in the channel program. 
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8. ICNRSTIC - Read Start TIC: This ccw is used to chain to the first Read ccw. 
The virtual address of this ccw points to the first Read buffer on the chain, 
except: 


e When deblocking Pius, in which case the virtual address is changed by the 
channel end appendage. 


e When there are not enough read buffers available, in which case it is zero. 


9. Read CCWs Alternating with TICs: Figure 73 on page 502 shows the buffers 
required for reading three Pius. 


10. Read No-Op: This ccw should never be executed. If it is, it indicates that the 
controller and vTAm do not agree on how many Read buffers are required. 


The normal ending status for a Read is channel end/device end/attention/unit 
exception. The unit exception indication is presented on the Read ccw that has 
completed data transfer, and terminates the command chaining. The attention 
is the same as a unit exception but it also indicates that a Read is requested. 


Unit exception may also be presented to the Read Start ccw. This is used by 
the controller to release input buffers. !f the same Read Start (as opposed to 
the alternate Read Start) is given to the controller, the data buffers must be 
re-sent. 
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PUNS-Related Channel Programs 


During activation of an Ncp in a channel-attached communication controller, the 
sscp sends a Contact RU to PUNS. PUNS responds by giving control to IsTTSCP4 to 
schedule one of five channel programs. These channel programs follow (A —E). 


a enn 


Code 
CCW (hex) Flags Notes 
SS aN Fe a Ea eee 
A. Sense 04 SLI Determines if the device needs to be 
loaded. 
ae ea a a i an ee ee 
B. Write XID 61 SLI,CC This channel program follows A if the 
~ No-Op 03 SLI device does not need to be loaded. It is 
followed by either C or D. 
Cc. Write Break 09 SLI,CC This channel program follows B if there is 
Read XID 62 SLI,CC (nocommand reject. 
Read 02 SLI,CC 
No-Op 03 SLI 
D. Restart/Reset 93 SLI,CC Executed only if the Write xip in B caused 
No-Op 03 SLI a command reject (implies the NCP is NCP 
Release 2 or earlier). 
E. Contact C3 SLI,CC  Restart/Reset is executed only if a Con- 
Restart/Reset 93 SLI,CC _tacted (error) response is sent to PUNS. 
No-Op 03 SLI 


One of the following channel! programs is executed when the sscp sends a Discon- 
tact RU to PUNS. 


Code 
CCW (hex) Flags Notes 
F. Discontact A3 SLI,CC This channel program is executed only if 
No-Op 03 SLI B did not cause a command reject. 
G. No-Op 03 SLI This channel program is executed if B 


Caused a command reject. 


These ccws are contained in !/O buffers that are allocated from the ioBuF buffer pool 
when doing PUNS I/O. : 


The data area pointed to by the address portion of a Read xID or Write xiD ccw is 
described in V7AM Data Areas (see ISTXID). 
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The following channel programs are written by adjacent physical unit network ser- 
vices (APUNS) for pseudo-dial support of a type 2 physical unit. 


eee 


Channel 
Program 
Name CCW 


Code 
(hex) Flags 


Notes 


eee 


A. Dial Out Sense 


No-Op 


04 
03 


SLI,CC Executed when the sscp 

SLI sends a Connect Out 
request to PUNS. Success 
means the physical con- 
nection is complete. 
Failure means the device 
is not operational. 


B. Dial 
Enable 
Answer 


Sense 
No-Op 


Cc. Dial 
Contact 
(Connect) 


IPL (Connect) 
Restart/Reset 
No-Op 


D. Abandon vibes 
Connection (Disconnect) 
No-Op 


04 
03 


05 
93 
03 


05 
03 


— SLI,CC 


SLI,CC Executed when the sscp 

SLI sends an Activate 
Connect In. Success 
means that the physical 
connection exists. (The 
type 2 physical unit is 
dialed in.) Failure means 
that the physical con- 
nection does not exist. 
(The type 2 physical unit 
has not dialed in yet.) 


SLI,CC Executed during acti- 

vation of a type 2 physical 

SLI unit when the sscp sends 
a Contact request to PUNS. 
The IPL ccw transfers 
initialization parameters 
to the device. The 
Restart/Reset ccw resets 
the Read/Write indicators 
so that VTAM and the 
device are synchronized. 


SLI,CC Executed when the sscp 

SLI sends an Abandon Con- 
nection RU to PUNS to dis- 
connect the type 2 
physical unit. 


These ccws are contained in pageable working storage allocated by APUNS 


(ISTINCYOQ). 


Figure 76 on page 510 shows the data area pointed to by an ip. (Connect) ccw. 


Figure 77 on page 510 shows the data area pointed to by an iPL (Disconnect) ccw. 
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No. of 
~~~ + —--— ———_ 


Length Code Header 


Size of 
Buffers 


Figure 76. Data Area Pointed to by an IPL (Connect) CCW 


0004 
~~ +-—_-—— 
Length Code 


Figure 77. Data Area Pointed to by an IPL (Disconnect) CCW 


Channel Programs for Channel-to-Channel Adapters 


Channel Programs for Channel-to-Channel Adapters for Pre-V3R2 
The following applies to VTAM V3R1, V3R1.1, and V3R1.2 in which the “ctc 
enhancement” PTF has not been applied. If the “ctc enhancement” PTF has been 
applied to your VTAM V3R1, V3R1.1, Of V3R1.2 system, or if you are using VTAM V3R2, 
please see “Channel Programs for Channel-to-Channel Adapters for V3R2” on 
page 514 for the description of channel programs for channel-to-channel adapters. 


Each side of a channel-to-channe! adapter (cTCA) is represented by a cross-channel 
node control block (xcncB). In addition, each side has a physical unit service vo 
(PIO) control block and a station control block (scs). The Pio is used for exchange ID 
(xID) channel programs (the physical unit services i/o that occurs before the link is 
active). The Pio is mapped by Istpio. The scs is a station work area where ccws 
for normal data transfer are built. it is not mapped, and is not described in VTAM 
Data Areas. 


Normal data transfer channel programs can be either a sequence of write ccws fol- 
lowed by read ccws (this is on the X-side) or a sequence of read ccws followed by 
write Ccws (on the Y-side). vTAM determines which side will be the X-side and 
which side will be the Y-side during the initial xiD channel program (the 
X-side/Y-side usage does not depend on the hardware attachment). From that 
point on, the X-side of the adapter always builds a channel program with the write 
ccws first, followed by read ccws. TheY-side of the adapter always builds a corre- 
sponding channel program with read ccws first, followed by write ccws. 


Figure 78 on page 511 shows how vtTam determines which side will be the X-side 
and which side will be the Y-side. In this example, the operator in subarea 4 is the 
first to activate the link. Because subarea 2 is not active, the xip exchange does 
not complete. Later, when the operator in subarea 2 activates the link, the xib 
exchange completes. 
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During the xiD exchange, each host informs the other host of the size and number 
of read buffers that will be used in the read portion of its channel programs. Each 
host then tailors the write portion of its channel programs to exactly match the read 
portion of the other host’s channel programs. Figure 79 on page 512 and 

Figure 80 on page 513 show how a write channel program might have to be tai- 
lored to match a read channel program. 


Subarea 4 Subarea 2 
SSCP PUNS Tsc CTCA TSC PUNS 
q 
i 
V NET,ACT, 
ctcalinkname ADDLINK 
+RESP 
] 
ACTLINK 
= RUPE i ¢ 
DCM, 7 
CE/DE 
$+} 
Post 2 
+RESP 
ADDLINKSTA 


+RESP 
CONTACT 
+RESP XIDO(4) 


{ 
4 
d 
1 
i 
t 
i 
( 
i] 
] 
i] 
¢ 
1 
J 
J 
i] 
i] 
I 
t 
CONTACT 
; ma from SSCP 
dceae BI xivoi2)| 
di | — X1DO(2) 
xIDO(4) ! 
XIDO(4) 
i 
X1D7(2) 
' — ¥1D7(4) 
] 
XID7(2) 
{ 
XID7(4) 
] 
' 
CONTACTED XID7(4) 3 
( 
X1D7(4) 
CONTACTED 
(to SSCP) 


Figure 78. Example of an XID Exchange 
PUNS queues a RUPE to NCBPUPAB, causing TSC to get control. 


TSC posts PUNS. 


};} Subarea 4 assumes X-side protocols because it is initiating the XID exchange. 
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| The XID exchange “times out" because the link in subarea 2 has not been acti- 
vated. Subarea 4 then assumes Y-side protocols and waits for the other side to 
initiate its contact procedure. 


Assume the operator activates the link in subarea 2. Subarea 2 assumes 
X-side protocols. 


sends a CONTACTED RU to the SSCP. 


Other Side’s 
SCB Write Buffer Read Buffer 


Write Buffer eee eee 


End of Data 


Figure 79. Writing from Large Buffers into Small Buffers. in this example, the write buffers are larger than the read 
buffers. Since the second and third Write CCWs are writing into the same read buffer, the second Write 


CCW has the Chained Data (CD) bit set on, and the second and third CCWs cause a single write opera- 
tion. 
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Other Side’s 
SCB Write Buffer Read Buffer 


Write Buffer 


‘o* 
o* 
oo 
- 
aoe 
oe 
oe 
o 
* 
one 
are 
oe 
o 
a" 
eo 
= 
oo 
- 
Sia 
Pr 
Pr 


Figure 80. Writing from Small Buffers into Large Buffers. In this example, the read buffers are larger than the write 
buffers. Therefore, two consecutive write operations are required to filt one read buffer. The first Write 
CCW has the Chained Data (CD) bit set on, since the first and second Write CCWs are writing into the 
same read buffer. 
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Channel Programs for Channel-to-Channel Adapters for V3R2 
The following applies to VTAM V3R2, and to VTAM V3A1, V3R1.1, and V3R1.2 with the “cTc 
enhancement” PTF applied. References to PRE-V3R2 are for VTAM V3R1, V3R1.1, and 
v3R1.2 in which the “ctc enhancement” PTF has not been applied. 


During xID processing, vTAM indicates the support level of CTC communications. If 
the other host in the connection is back-level, the support used will be the vTAM CTC 
support as described in “Channel Programs for Channel-to-Channel Adapters for 
Pre-V3R2” on page 510. 


VTAM V3R2 reduces the number of Ccws exchanged during xIo processing. 


Prior to v3n2, there were MAXBFRU READS and w)”liTEs, plus a constant seven environ- 
mental Ccws. 


With v3R2, MAXBFRU defines a single READ buffer. The opposing VTAM write buffer is 
exactly the same size. Pius are blocked for transfer, and are written by a single 
WRITE, and read by a single READ. 


With the new blocking protocol, there are just three Ccws. v3R2 uses the WRITE and 
READ CCWS, as well as a ccw which is either a wcTL or ScB. For each buffer write, 
only 3 ccws are exchanged in v3R2. Control information is included with the first 
buffer transferred in the same Ccw as the Pius in the block. This eliminates the use 
of WRITE CONTROL, READ CONTROL, validity check, and NO_OP CCws. 


Each side of a channel-to-channel adapter (cTca) is represented by a cross-channel 
node contro! block (xCNCB/YCNCB). In addition, each side has a physical unit service 
1/0 (PIO) contro! block. The Pio is used for exchange (D (xID) channel programs (the 
physical unit services 1/0 that occurs before the link is active). The Pio is mapped 
by ISTPIO. 


Normal data transfer for channel programs is a write ccw followed by a read ccw 
(this is on the X-side) or a read Ccw followed by a write ccw (on the Y-side). VTAM 
determines which side will be the X-side and which side will be the Y-side as 
described in “Channel Programs for Channel-to-Channel Adapters for Pre-V3R2” 
on page 510. 


During the xi0 exchange, each host informs the other host of the size in pages of 


the read buffer that will be used in the read portion of its channel programs. Each 
host then allocates a write buffer to exactly match the READ buffer of the other host. 
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Channel Commands 


The following channel commands are used for channel programs between two 
hosts connected by a channel-to-channel adapter. 


Description 


Command 

Code 

(hex) Command 

01 Write 

02 Read 

03 No-Op 

08 TIC 

14 Sense Command 
Byte (SCB) 

17 Write Control (WCTL) 
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Transfers data from storage to this host 
processor to the Ctca. For cTcas, this ccw is 
used to transfer status information from 
XCNOCTL, XID information from PIOPOTXT, validity 
checking information from xCNOvTXT, and data 
from buffers. 


In VTAM V3R2, Status information, mapped by 
XCNOCTL, is transferred in the first eight bytes 
of the write buffer, and only one write buffer is 
used. Figure 81 on page 516 illustrates the 
buffer usage in v3n2. 


Transfers data from the CTCA to this host 
processor. For ctcas, this ccw is used to read 
status information into XCNICTL, xID information 
into PIOPITXT, validity checking information into 
XCNIVTXT, and data into buffers. 


In VTAM V3R2, Status information, mapped by 
XCNICTL, is transferred in the first eight bytes of 
the read buffer, and only one read buffer is 
used. Figure 81 on page 516 illustrates the 
buffer usage in v3R2. 


Causes the channel to respond with a channel 
end or device end. It is the last Ccw in a read 
or write chain. 


Causes the channel program to execute an 
instruction that is not the next sequential 
instruction within the channel program 
sequence. 


The ScB is normally issued in response to an 
attention generated when the adapter proc- . 
esses a WCTL from the other side. The scB 
clears WCTL from the adapter, allowing the 
WCTL Ccw to complete. 


Causes an attention interruption on the other 
side of the channel-to-channel adapter. The 
WCTL is issued to alert the other side that a 
channel program is active at the adapter. 
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Command 
Code 
(hex) Command Description 
43 Enable Compatibility Prepares the adapter to operate in 
Mode (ECM) System/360 (compatibility) mode. The Ecm is 
issued when VTAM gives up control of the 
adapter. 
C3 Disable Compatibility Prepares the adapter to operate in 
Mode (DCM) System/370 (Extended) mode. The 0cn is 
issued when VTAM acquires control of the 
adapter. 


Read 
Buffer 


YCNCB 


YCNIBUF 
YCNOBUF 


Figure 81. Buffers Used for Normal Data Transfer in V3R2 


1. The first eight bytes of the READ buffer is the control information mapped by 
XCNICTL. 


2. The first eight bytes of the write buffer is the contro! information mapped by 
XCNOCTL. 
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Channel Programs 


XID Channel Program (X-Side) 


Figure 82 on page 518 shows the data areas associated with the following xID 
channel program. 


Command 
Code 
CCW (hex) Flags Address Count 
1 Write 17 CC,SLI Zero 1 
Control 
2 TIC 08 — Write CCW — 
(Pre-V3R2) 
Write 01 CC,SLI XCNOCTL 8 
4 Write 01 CC,SLI PIOPOTXT Length of XiD 
5 =6TIC 08 — Read CCW _ 
(Pre-V3R2) 
6 Read 02 CC,SLI XCNICTL 8 
7  #Read 02 CC,SLI PIOPITXT Length of XID 
8 TIC 08 — Read CCW — 
(Pre-V3R2) 
9 Read 02 CC,SLI XCNOVTXT 4 
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XCNCB PIO 


Write (status) CCW © 


Write (XID) CCW 


cal 


= 
oO 


Read (status) CCW 


oa 


Read (XID) CCW 


TIC 


aie =Transfer in Channel 


Figure 82. Data Areas Used for X!D Channel! Programs (X-Side) 
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XID Channel Program (Y-Side) 


Figure 83 shows the data areas associated with the following xip channel program. 


Command 
Code 
CCW (hex) Flags Address Count 
1 Sense 14 CC,SLI Zero 1 
Command 
Byte 
2 TIC 08 — Read CCW — 
(Pre-V3R2) 
3 Read 02 CC,SLI XCNICTL 8 
4 Read 02 CC,SLI PIOPITXT Length of XID 
TIC 08 — Write CCW — 
(Pre-V3R2) 
6 Write 01 CC,SLI XCNOCTL 8 
7 Write 01 CC,SLI PIOPOTXT Length of XID 
8 TIC 08 — Write CCW — 
(Pre-V3R2) 
9 Write 01 CC,SLI SCNOVTXT 4 
XCNCB 


NCBCAW 


Sense Command Byte 
CCW 


p> =Transfer in Channel 


PIO 


| senor 


Figure 83. Data Areas Used for XID Channel Programs (Y-Side) 
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Normal Data Transfer (X-Side) in Pre-V3R2 


520 VTAM Diagnosis 


Figure 84 on page 521 shows the data areas associated with the X-side of a 
normal data transfer channel program in PRE-v3R2 processing. 


Sa SS SS 


Command 
Code 
CCW (hex) Flags Address Count 
1 WCTL% or 17/ CC,SLI Zero 1 
SCB 14 
2 TIC 08 — Write CCW — 
3. Write 01 CC,SLI XCNOCTL 8 
4 TIC 08 _ Write CCW — 
Write 01 CC,SLI Buffer Length 
: ( CD) 
5 Write 01 CC,SLI, Buffer Length 
3 01 ( CD) 
Write oe Buffer Length 
6 TIC 08 _ Read CCW — 
7 Read 02 CC,SLI XCNICTL 8 
8 TIC 08 — Read CCW — 
Read 02 CC,SLI Address Length 
of Data 
9 TIC 08 _ Read CCW — 
Read 02 CC,SLI Address of Data Length 
TIC 08 — Write CCW — 
10 Write 01 CC,SLI XCNOVTXT 4 


3 wcTL is used when this host is initiating a write operation. scB is used when this host is 
responding to an attention (because the other host has data that it wants this host to 
read). 
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XCNCB —SCB 
NCBCAW Write CCW 
Write CCW 
Si 
ab WCTL or SCB Poe 
= Write CCW 
‘2 IC 


TIC 


: 
a ae 
a ome | 


ol Read (status) CCW 
Write (VALCHECK) CCW 


F. ore 
er 
ne ee a 
Be 

I 


KE} Read Buffers 


Read CCW Read CCW 


EE = Transfer in Channel 


Figure 84. Data Areas Used for Normal Data Transfer (X-Side) in Pre-V3R2 
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Normal Data Transfer (Y-Side) in Pre-V3R2 


522 VTAM Diagnosis 


Figure 85 on page 523 shows the data areas associated with the following normal 
data transfer channel program. 


rE 


Command 
Code 
CCW (hex) Flags Address Count 

Fe aia k oa Sg NI AISLE AA Een ee A 

1 WCTL‘or 14/ CC,SLI Zero 1 
SCB 17 

a 

2 TIC 08 — Read CCW — 

3 Read 02 CC,SLI XCNICTL 8 

4 TIc 08 — Read CCW — 
Read 02 CC,SL! Address Length 

of Data 
TIC 08 — Read CCW — 

5 

Read 02 CC,SLI Address Length 
of Data 
TIC 08 — Write CCW _ 

6 Write 01 CC,SLI XCNOCTL 8 
TIC 08 — Write CCW _— 
Write 01 CC,SLI, Buffer Length 
(CD) 

8 Write 01 CC,SLI, Buffer Length 
( CD) 
Write 01 CC,SLI Buffer Length 

9 #@TIC 08 — Read CCW — 

10 Read 02 CC,SLI XCNIVTXT | 4 


4 wCTL is used when this host is initiating a write operation. scs is used when this host is 
responding to an attention (because the other host has data that it wants this host to 
read). 
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XCNCB SCB 
NCBCAW 


WCTL or SCB 


Write CCW 


Write CCW 
Write CCW 


Read CCW 


TIC 


=> =Transfer in Channel 


Figure 85. Data Areas Used for Normal Data Transfer (Y-Side) in Pre-V3R2 
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Normal Data Transfer (X-Side) for V3R2 
Figure 86 shows the data areas associated with the X-side of a normal data 
transfer channel program in v3R2 processing. 


Command 
Code 
CCW (hex) Flags Address Count 
1 WCTLS or = 17/ CC,SLI Zero 1 
SCB 14 
2  #£«.Write 01 CC,SLI YCNWRIDA Number of 
bytes to 
transfer 
3 Read 02 SLI YCNRDIDA Total length 
of Read 
Buffer 
YCNCB 


Write CCW 
YCNCCWWR 


Read CCW 
YCNCCWRW 


List of pointers to 
2K increments of 
Write Buffers 


> me ee = er ee re we es ee. 


YCNRDIDA 


oe aa oe oe a ow re od oe oe er oe oe ee ee 9 2 2 ee er ee oe ee es es 9 ee es es es es es ee ee oe ee | 


List of pointers to 
2K increments of 
Read Buffers 


Figure 86. Data Areas Used for Normal Data Transfer (X-Side) in V3R2 


5 wcCTL is used when this host is initiating a write operation. sca is used when this host is 
responding to an attention (because the other host has data that it wants this host to 
read). 
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Normal Data Transfer (Y-Side) in V3R2 


Figure 87 shows the data areas associated with the following normal data transfer 
channel program in v3R2 


Command 
Code 
CCW (hex) Flags Address Count 
1 WCTLS& or 17/ CC,SLI Zero 1 
SCB 14 
2 Read 02 CC,SLI YCNRDIDA Tota! length 
of Read 
Buffer 
3. ~=6Write 01 SLI YCNWRIDA Number of 
bytes to 
transfer 
YCNCB 


Write CCW 
YCNCCWWR 


Read CCW 
YCNCCWRW 


List of pointers to 
2K increments of 
Read Buffers 


YCNRDIDA 


ow eet Re oe oe oe ee oe oe ee ee es es es ee = 9 ee 


List of pointers to 
2K increments of 
Write Buffers 


2 oe oe on oe ee ee es ee Oe ee See Se eS eS eS SH Se SS SS eee eee 


Figure 87. Data Areas Used for Normal Data Transfer (Y-Side) in V3R2 


6 wCTL is used when this host is initiating a write operation. sce is used when this host is 
responding to an attention (because the other host has data that it wants this host to 
read). 
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Channel Programs for Channel-Attached Non-SNA 3270 Devices 


The publications for the non-SNA 3270 devices contain diagnostic procedures. For 
more information, see the 3270 Component Description. 


The LDNCB represents local devices and contains addresses and ccws needed for 
channel programs. Figure 88 shows the LDONCB and the location in storage of 
various CCWs. 


LONCB 


NCBCAW 


aa Length 


LDNSLCCW 
(Select CCW) 


LDNTICCW 
(TIC CCW) 


Address of 

Active Request LDNACREO 

Elements 

Read Buffe 

Length : { LONRBLEN 

Read Modified 

Length LDONRMLEN |; 7 ‘*Se7" Only when there is a Select CCW 


Figure 88. Data Areas Used by a Channel Program for Channel-Attached Non-SNA Devices 
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Channel Command Words 


The following channel commands are used by vTAm to send data to and to receive 
data from channel-attached non-sna 3270 terminals. 


Command 

Code 

(hex) Command Description 

01 Write Transfers data from storage in the host 
processor to the i/o device. Modifies existing 
buffer data. 

02 Read or Transfers the entire buffer contents from the vo 

Read Buffer device to storage in the host processor. 

05 Erase/Write Clears the device buffer before starting the 
Write. 

06 Read Modified Transfers data (that was modified since the last 
Read) from the i/o device to storage in the host 
processor. 

0B Select Transfers data from the /o device buffer to the 
controiler buffer. Separates the device-to- 
controller unit buffer transfer from the execution 
command. 

0D Erase/Write Same as Erase/Write, except that it allows for a 

Alternate larger buffer size required for some devices. 
1B Select Read Same as Select, except that it is only used for 
Buffer Read Buffer channel programs. 
4B Select Write Same as Select, except that it is only used for 
Write channel programs. 
OF Erase All Clears all unprotected buffers 
Unprotected 

11 Write Writes a structured field 
Structured 
Field 
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The following tables show the ccws used in various channel programs. The order 
of execution is the same as the order in which they appear. 


Write Data Channel Program 


CCW 
Select 
TIC 


As many as Write® 
needed 


Command 
Code 
(hex) 


OB or 4B’ 
08 
01 


Flags 
CC,SLI 


CD,SLI 


Address Count 
Zero 1 
Write CCW — 


Output Area Length 


7 {f the ucs indicates that the device will accept the Select Write, code X'4B', it is used 
until a command reject is received. Then Select, code X'0B', is used. 


8 The first Write ccw is pointed to by LONACREQ. The last Write ccw is not Command Code 


X‘'1B'. 
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Read Modified Channel Program 


Command 
Code 
CCW (hex) Flags Address Count 
Select 0B CC,SLI Zero 1 
TIC 08 = Read Modified — 
CCW 
As many Read 06 CD,SLI Input Area Length 
as needed Modified? 
TIC 08 — Ready Modified Length 
CCW 
Read 06 CD,SLI Input Area Length 
Modified" 
Read 06 SKIP, Zero X'7FFF' 
Modified SLI 
(Skip) 


9 The first Read Modified ccw is pointed to by LONACREQ. 


10 The number of bytes transmitted in the previous Read Modified ccw is stored in the 
LONRMLEN field in the Loncs. For this Read Modified, enough buffers are allocated to hold 
LONRMLEN bytes of data. If this is not enough buffers for the device to send all of the 
pending data, the channel program will end on the Read Skip ccw. The Read Skip ccw 
reads all of the pending data but does not transmit any of it. The new length is stored in 
LONRMLEN. (The length is computed by subtracting the residual byte count in the csw 
from X'7FFF'.) Then, the channel program is executed again with enough buffers allo- 
cated to read and transmit all of the pending data. 
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Read Buffer Channel Program 


530 


VTAM Diagnosis 


ep ys SS 


Command 
Code 
CCW (hex) Flags Address Count 
Select 0B or 1B" CC,SLI Zero 1 
TIC 08 — Read Buffer — 
CCW 
As many Read 02 CD,SLI Input Area Length 
as needed’ Buffer’? 
TIC 08 — Read Buffer _ 
CCW 
Read 02 CD,SLI Input Area Length 
Buffers 
Read 02 SKIP, Zero X'7FFF' 
SLI 
Buffer 
(Skip) 


11 If the ucs indicates that the device will accept the Select Read, code X'1B', it is used 
until a command reject is received. Then Select, code X'0B', is used. 


12 The first Read ccw is pointed to by LONACREG. 


13 The number of bytes transmitted in the previous Read Buffer ccw is stored in the 
LONRBLEN field in the Loncs. For this Read Buffer, enough buffers are allocated to hoid 
LONRBLEN bytes of data. If this is not enough buffers for the device to send all of the 
pending data, the channel program will end on the Read Skip ccw. The Read Skip ccw 
reads all of the pending data but does not transmit any of it. The new length is stored in 
LONRBLEN. (The length is computed by subtracting the residual byte count in the csw 


from X'7FFF'.) Then the channel program is executed again with enough buffers allo- 
cated to read and transmit all of the pending data. 
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Erase/Write Channel Program 


eee 


Command 
Code 
CCW (hex) Flags Address Count 
As many Erase/ 05 CD,SL! Output Area Length 
as needed Write 
TIC 08 — Erase/Write — 
CCW 
Erase/ 05 SLI Output Area Length 
Write 
Erase/Write Alternate Channel Program 
Command 
Code 
CCW (hex) Flags Address Count 
As many Erase/ 0D CD,SLI Output Area Length 
as needed _ Write's 
Alternate 
TIC 08 — Erase/Write — 
Alternate CCW 
Erase/ OD SLI Output Area —— Length 
Write 
Erase Ali Unprotected Channel Program 
Command 
Code 
CCW (hex) Flags Address Count 
Erase All's OF SLI Zero 1 


Unprotected 


14 LDNACREQ has the address of the first Erase/Write ccw. 
15 LONACREQ contains the address of the first Erase/Write Alternate ccw. 


16 LONACREQ Contains the address of the Erase Ali Unprotected ccw. 
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vm vse BS9C Communication Adapter Line Channel Programs 


The BSCLB represents a BSC line attached through a Bsc communication adapter 
and contains addresses and ccws needed for channel programs. See the /BM 9370 
Information System: Telecommunications Subsystem Description and Reference 
or the IBM 4361 Processor Communication Adapter for a detailed description of 
channel programs, the interface between vTAM and the telecommunications sub- 
system or communication adapter, and the sense codes returned from a telecom- 
munications subsystem or communication adapter. 


vu vse Channel Commands 
The following channel commands are used by VTAM to write data to or read data 
from a BSC terminal attached through a communication adapter line. Of the 
channel commands supported by the BSc communication adapter, VTAM only uses 
those required for master-station multipoint operations. 


Command 

Code 

(hex) Command Description 

01 Write Transfers data from storage in the host processor to 
the BSc device. 

02 Read Transfers data from the control unit to storage in the 
host processor. 

03 No-Op Used to stop channel program execution (for example, 
General Poll). It also causes the channel to respond 
with a channel end and device end. 

04 Sense Transfers two bytes of sense data to VTAM. 

08 TIC (Transfer Requests a transfer in the channel program. It causes 

in Channel) the channel program to execute a command other 
than the next sequential command in the channel 
program. 

09 Poll Starts the autopoll of the poll list at the entry speci- 
fied. 

23 Set Mode Used to condition a line in an Enable Write channel 
program. It sets the desired operating environment. 

27 Enable Sets the Bsc line to the enabled state. It is the last 
command in an Enable Write channel program. 

2F Disable Sets the line to the disabled state. It is a part of the 


Enable Write and Disable channel programs. 


vu vse (/O Scheduling Overview of BSC Lines 
During activation of a BSC line, a polling list is constructed containing entries for all 
of the BSc cluster controllers that are defined for the line. Initially, all the poll list 
entries are inactive and no //O is started. 
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At the time a Contact ru is processed for the cluster controller, activation proc- 
essing activates the appropriate polling list entry and, if it is the first cluster on the 
line to be activated, causes the General Poll channel program to be started. The 
General Poll channel program is designed to run continuously, without interruption 
, aS long as negative responses to poll (EoTs) are being received. When an inter- 
ruption occurs, VTAM analyzes the non-negative response to determine the next 
action. 


Normally, it would be a Continue Read channel program to acknowledge the pre- 
vious response and to solicit the next transmission. The Continue Read channel 
program is issued repeatedly until an EoT is received that indicates that the cluster 
controjler has completed its data transmission. 


Upon receipt of an EoT, the station pending traffic queues are checked for pending 
output to any active terminal on the line. If any is found, that transmission is 
scheduled prior to restarting the General Poll. Any pending activation or deacti- 
vation of polling list entries is done at this time as well. 


lf output 1/0, activation, or deactivation occurs while the General Poll is active, but 
prior to an interruption, the General Poll is stopped to allow this processing to 
proceed. This is accomplished in a controlled manner by changing the Tic (the 
sixth command) in the General Poll channel programs to a No-op. Changing the Tic 
to No-op causes the channel program to end when it has polled all entries in the 
polling list. 


Following completion of any scheduled operations, the General Poll is restarted at 
the first entry in the polling list. If General Poll is restarted after the completion of 
a General! Poll, it is restarted at the next entry from the one that caused the 
General Poll to be completed. This ensures an even distribution of poll operations 
among the cluster controllers on a line. 


The following channel programs are used in the 1/0 sequence that sends data to or 
receives data from a ssc terminal. 


Note: Except for the Enable Write and Disable Write channel programs, all of the 
channel programs (or portions of them) are in the 8SCLB (BSC line contro/ block). 
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vu vse Channel Programs 
The following tables illustrate the Ccws used in various channel programs. 


vm vse Enable Write Channel Program 
This channel program is started for ACTLINK processing in order to condition and 
enable the line. 


Command 
Code 
No. CCW (hex) Flags Address Count 
(1) Disable 2F CC,SLI — 1 
(2) Set Mode 23 CC,SLI Control 1 
Information 
(3) Enable 27 SLI — | 


vu vse Disable Write Channel Program 
This program is started for DACTLINK processing in order to disable a line. 


Command 

Code 
No. CCW (hex) Flags Address Count 
(1) Disable 2F SLI — 1 
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vm vse General Poll (Initial Read) Channel Program 


To solicit data from Bsc terminals, this program is constructed to allow polling to 
begin with any entry in the poll list and to continue wrapping through the list until: 


¢ A non-negative response is received from a terminal. 
¢ The channel program is stopped for the scheduling of output. 
e The operations terminate. 


The program also is updated dynamically to reflect a changed poll list entry, poll 
list length, or read data area. When this program is initiated, the BSCOCFSM, 
BSCPCFSM, and BSCCCFSM fields of the BSCLB are set to X'01'. 


Command 
Code 
No. CCW (hex) Flags Address Count 
(1) Write 01 CC,SLI EOT 1 
(2) Poll 09 CC,SLI Poll list entry n+ 1 
(3) TIC 08 —~ Command (5) 1 
(4) TIC 08 —~ Command (7) 1 
(5) Poll 09 CC,SLI First entry m+ 1 
poll list 
(6) TIC 08 — Command (5) 1 
(7) Read 02 SLI I/O buffer Length 


vu vse Continue Read Channel Program 
This program is used after either an Initial Read channel program or another Con- 
tinue Read channel program. It sends a positive acknowledgment to previously 
received data and to read in additional data. When this program is executing, the 
BSCOCFSM, BSCCPFSM, and BSCCCFSM fields of the BSCLB are set to X'02'. 


Command 

Code 
No. CCW (hex) Flags Address Count 
(1) Write 01 CC,SLI ACKO or ACK1 2 
(2) Read 02 SLI I/O buffer Length 
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vm vse Repeat Read Channel Program 


During error recovery procedure (ERP) for BSC lines, this channel program is exe- 
cuted to request that the terminal retransmit the previous text block in whicha 
“block check” error was detected. At this point, the BSCOCFSM, BSCPCFSM, and 
BSCCCFSM fields of this BSCLB are set to X'0B'. 


Command 

Code 
No. CCW (hex) Flags Address Count 
(1) Write 01 CC,SLI NAK 1 
(2) Read 02 SLI I/O Buffer Length 


vm vse Interrupt Write Channel Program 


When the inbound data flow must be stopped immediately, the Interrupt Write 
channel program is used to stop the General Poll (Initial Read) channel program. 
In order to prevent data loss, the channel program is executed following a text 
block that ends with ETx. The BSCCCFSM and BSCPCFSM fields of the BSCLB are set to 
X'0C'. 


Command 

Code 
No. CCW (hex) Flags Address Count 
(1) Write 01 CC,SLI RVI 2 
(2) Read 02 SLI Response area 2 


vm vse Reset Write Channel Program 
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The Reset Write channel program is used to write an EOT to the terminal and to 
return the line to control mode. When this program is executing, the BSCCCFSM AND 
BSCPCFSM fields of the BSCLB are set to X'07'. 


Command 

Code 
No. CCW (hex) Flags Address Count 
(1) Write 01 SLI EOT 1 
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vi: vee Status Read Channel Program 
The Status Read channel program is executed when a terminal indicates that it has 
pending BSC sense/status information. The program specifically polls the terminal 
and reads the Bsc sense/status information only. The BSCCCFSM AND BSCPCESM fields 
of the related BSCLB are set to X'0A'. 


Command 
Code 
No. CCW (hex) Flags Address Count 
(1) Write 01 CC,SLI EOT 1 
(2) Write 01 CC,SLI Specific poll 5 
characters 
(3) Read 02 SLI 1/O buffer Length 


via vse Inquiry Read Channel Program 
The Inquiry Read channel program clears a communication adapter line buffer. 
Any data read is discarded because of the skip flag in the program's Read ccw. 
The BSCCCFSM and BSCPCFSM fields of the BSCLB are set to X'0D'. 


Command 

Code 
No. CCW (hex) Flags Address Count 
(1) Read 02 SLI,SKIP Response area 4095 


wa vee PENSE Channel Program 
The Sense channel program is issued when vTAM receives unit-check status from 
the communication adapter. 


Command 

Code 
No. CCW (hex) Flags Address Count 
(1) Sense 04 SLI Sense area 2 
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vm vse Initial Write (Conversational) Channel Program 
A variation of the Initial Write channel program, the Initial Write (Conversational) 
channel program performs a required conversational function. This function allows 
a terminal to respond to a text block with another text block, rather than with a 
response. The channel program must have an appropriate length buffer ready to 
receive the text block. The BSCOCFSM, BSCCCFSM, and BSCPCFSM fields of the BSCLB 
are set to X'08' when an Initial Write (Conversational) channel program is exe- 
cuting. They are set to X'04' when an Initial Write channel program is executing. 


Command 
Code 
No. CCW (hex) Flags Address Count 
(1) Write 01 CC,SLI EOT 1 
(2) Write 01 CC,SLI Selecting characters 5 
(3) Read 02 SLI Response area 2 
(4a) Write 01 CD,SLI STX ESC characters 2 
(4b) TIC 08 — Command (4c) in I/O buffers 1 
(4c) Write 01 CD,SLI Data in I/O buffer Length 
(4d) TIC 08 — Command (4e) 1 
(4e) Write 01 CC,SLI ETX character 1 
(5a) Read 02 SLI Response area 2 
(5b) Read 02 SLI I/O buffers Length 


vm vse Inquiry Write (Conversational) Channel Program 
The Inquiry Write channel program is issued during ERP (error recovery procedure) 
in order to request the terminal to retransmit its last response. The BSCCCFSM and 
BSCPCFSM fields of the BSCLB are Set to X'06'. 


Command 
Code 
No. CCW (hex) Flags Address Count 
(1) Write 01 CC,SLI ENQ 1 
(2a) Read 02 SLI Response area 2 
(2b) Read 02 SLI 1/O buffer Length 
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vm vse Channel Program Finite State Machines for BSC Lines 
The finite state machine (FSM) represents what is happening on the BSc line. The 
following table shows the finite state machines and what they mean. 


FSM State Explanation 
(1) GP General Poll The General Poll channel program is executing. 
(2) CR Continue Read The Continue Read channel program is exe- 
cuting. 
(3) CM Control Mode The BSC line is in control mode. No channel 
program is executing for the line. 
(4) [W1 Initial Write 1 The first part of an Initial Write channel program 
is executing. 
(5) IW2 Initial Write 2 The second part of an Initial Write channel 
program is executing. 
(6) INQ Inquiry Write An Inquiry Write channel program is executing. 
(7) EOT End of Trans- An EOT has been sent, or an EOT is expected. 
mission 
(8) IC1 Initial Write Con- The first part of an Initial Write Conversational 
versational 1 channel program is executing. 
(9) 1C2 Initial Write Con- The second part of an Initial Write Conversa- 
versational 2 tional channel program is executing. 
(10) STR Status Read A Status Read channel program is executing. 
(11) RR Repeat Read A Repeat Read channel program is executing. 
(12) IWT Interrupt Write An Interrupt Write Channel program is executing. 
(13) l|QR Inquiry Read An Inquiry Read channel program is executing. 
(14) l|QW Inquiry Write Con- An Inquiry Write Conversational channel 


versational 


program is executing. 


Figure 89 on page 540 shows the finite state machines representing activity ona 


BSC line. 


At the top of each column is the state that the line is in. The state is one of the 


following: 


¢ The channel program that is executing for the line 
e The condition of the line 


e An end of transmission (EOT). 


Above the arrow are the stimuli (flags, responses) that cause a state change. At 
the end of the arrow is the new state or a number that refers to a new state (the 
number at the top of a column). Below the arrow is the action that vTAM takes as a 
result of the state change: the action may be to send a response, to issue an RU 
such as a Station INOP or an exception request, or to set up a procedure to delay 
processing until a temporary condition has ended. 
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The following abbreviations are used in the diagrams: 


Gen Inbound 
Request 


SENSE STATUS 


Delayed Read; 
Gen Exception 
Request 

TRM 


Gen Inbound 


Occur (Retry) 
(11) 


Station Inop 


Gen Inbound 
Request 


SENSE STATUS 


Delayed Read; 
Gen Exception 
Request 

TRM 


Gen Inbound 


Occur (Retry) 
(11) 


Station Inop 


Figure 89 (Part 1 of 2). 
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ACKO Positive acknowledgement 0; alternates with Ack 
ACK1 Positive acknowledgement 1; alternates with ACKO 
ENQ Enquiry; requests a reply 
EOT End of transmission 
ETB End of test block 
ETX End of text 
NAK Negative acknowledgment 
RVI Reverse interrupt 
SOH Start of heading 
STX Start of text 
TRM Test request message 
(1) GP (2) CR (3) CM (4) [W1 (5) IW2 (6) INQ (7) EOT 
STX-ETB STX-ETB 
STX-ETX STX-ETX ACKO ACK1 ACK1 


(7) 
Gen Positive 
Response 


Send Outbound 
Text 


Gen Positive 
Response 
RVI 


ACKO (Retry) ACKO/NAK 


(10) 


Process Process 

Response Response 

No Buffer No Buffer ACKO/NAK 
(12) (12) Should- Not- (Retry Limit 

Set Up for Set Up for Occur (Retry) Exceeded) 


Aq) (9) 
Gen Negative 
Response 


Request Request 
q 
EOT Retry Limit 
Exceeded NAK (Retry) NAK 
Gen Negative es 
Response 
Should-Not- Should-Not- Should-Not- Should-Not- 


Occur (Retry) Occur (Retry) 


Retry Limit Retry Limit Retry Limit Retry Limit 
Exceeded Exceeded Exceeded Exceeded 

(3) (7) 
Process Process Gen Negative Gen Negative 


Response Response 


Finite State Machines for BSC Lines 
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(8) 1C1 (9) 1C2 (10) STR (11) RR (12) IWT (13) 1OR (14) 1aW 


Retry Limit 
Exceeded 


Gen Negative 
Response 


(7) 


sponse; Gen 
Excep Request 


STX-ENQ 
SOH-ENQ 
(Retry) 


(11) 


STX-ENQ 
SOH-ENQ 
(Retry Limit 
Exceeded) 


(3) 
Process 
Station Inop 


NAK (Retry) 


NAK (Retry 
Limit Exceeded) 
» (7) 
Gen Negative 
Response 


TRM 

(2) 
Gen Inbound 
Request 
Gen Posistive 
Response 


Should-not- 
Occur 
(7) 


Gen Negative 
Response 


sponse; Gen 
Excep Request 


STX-ENQ 
SOH-ENQ 
(Retry) 

(11) 


STX-ENQ 
SOH-ENQ 
(Retry Limit 
Exceeded) 


(3) 
Process 
Station Inop 


NAK (Retry) 


NAK (Retry 
Limit Exceeded) 
” (7) 
Gen Negative 
Response 


TRM 

(2) 
Gen Inbound 
Request 
Gen Positive 
Response 


Should-not- 
Occur 

” (7) 
Gen Negative 
Response 


Figure 89 (Part 2 of 2). VMVSE Finite State Machines for BSC Lines 
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ACKO STX-ETX SOH,%,R,STX-ETX | STX-ETX CE/CD, Initial STX-ETX 
(2) > (2) --——_? (2) ERR=Lost Data, }———————___® 
Send outbound | Gen Inb Re- Gen Response or Gen Inb Re- Retry Gen Inb Re- 
text quest, Pos Excep Request quest, Pos (3) (11)! quest, Pos 
Request Response Response 
Should-not- CE/DE. Initial 
RVI STX-ETB No Buffer STX-ETB Occur ERR=Lost Data,| STX-ETB 
(10) (2) (12) (2) (7) | Retry Exceeded (2) 
Gen Inbound Set Up for Gen Inbound (3) Gen Inbound 
Request Delayed Read Request Station Inop Request 
Should-not- No Buffer Should-not-Occur | No Buffer UE or Timeout No Buffer 
Occur (Retry) (12) > (7) (12) (*) (12) 
Set Up for Gen Neg Response | Set Up for Restart Prev set Up for 
Delayed Read; Delayed Read; Channel Delayed Read; 
Gen Pos Re- Gen Pos Re- Program Gen Exception 


Request 


STX-ENQ 
SOH-ENQ 


(Retry) 
(11) 


STX-ENQ 
SOH-ENQ 
(Retry Limit 
Exceeded) 


(3) 
Process 
Station Inop 


NAK (Retry) 


ee 


TRM 

(2) 
Gen Inbound 
Request 
Gen Positive 
Response 


ENQ 
(Retry) 


ENQ 
(Retry) 


Gen Negative 
Response 


Should-not- 
Occur 

(7) 
Gen Negative 
Response 
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eg Ee =e ee ee ae ee 
.. vee Channel Programs for an SDLC Communication Adapter Line 


The HALCB represents an SDLC line attached through an SDLC communication 
adapter and contains addresses and ccws needed for channel programs. See the 
IBM 9370 Information System: Telecommunications Subsystem Description and 
Reference or the /BM 4361 Processor Communication Adapter for a detailed 
description of channel programs, the interface between VTAM and the telecommuni- 
cations subsystem or communication adapter, and the sense codes returned from 
a telecommunications subsystem or communication adapter. 


v. vse Channel Commands 
The following channel commands are used in the channel programs to communi- 
cate with SNA devices on SDLC lines or with the SDLC lines themselves. 


Command 

Code 

(hex) Command Description 

01 Write Writes an SOLC command located in the TSCODATA 
field of the TSCB. 

02 Read Reads an SDLC command or control data located 
at TSCIDATA. 

03 No-op Used to stop channel program execution. 

05 Write PIU Points to TSCILNG, a two-byte prefix to TSCPIU. 
TSCILNG contains the total length of the data in the 
PIU. This length includes the TH, RH, RU, and 
TSCILNG. Data in any continuation buffers for the 
Write PIU channel program will start at TSCPIU as 
usual. 

06 Read PIU Points to TSCILNG, a two-byte prefix of TscPiu. The 
total length of the data is returned in TSCILNG. 
Data in any continuation buffers of the Read Piu 
channel program begins at TSCILNG. 

08 TIC Requests a transfer in the channel program. It 

(Transfer causes the channel program to execute a 
in command other than the next sequential 
Channel) command in the channel program. 

09 Autopoll Points to a polling list of scBs. The length is the 
length of the polling list. This command solicits 
input from active stations, contact polls those 
stations being activated, and ignores the inactive 
Stations. 

OB Control SCB Transfers 12 bytes of ScB information from VTAM 

(Control SPL) to the communication adapter. 
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EEE 


Command 

Code 

(hex) Command Description 

OF Poll Transfers a final RR or RNA after a chain of Write 
P commands. When the Poll command is exe- 
cuted, the line is turned to inbound. 

14 Sense SCB Retrieves the current scsB from the communi- 

(Sense SPL) cation adapter after a line operation completes. 
The current Scs indicates which station 
responded. 

23 Set Mode Transfers up to 8 bytes of setmode data to the 
communication adapter to change the status of a 
line. 

27 Enable Makes the line operational. 

29 Dial Transfers dialing data to the automatic calling 
unit (ACU). 

2F Disable Makes the line non-operational. 

E4 Sense 1/O Transfers up to 7 bytes of line configuration 


information from the communication adapter. 


vm vse 1/O Scheduling Overview of SDLC Lines 
During activation of an SDLC line, a station polling list (SPL) is constructed con- 
taining entries for all the physical units that are defined for the line. Initially, all the 
station entries are inactive. When any station has to be contacted and it is the first 
station on the line to be activated, the Autopoll channel program is started to do a 
Contact Poll. When a station sends in a nonsequenced acknowledgment (NSA), data 
polling begins. 


The Autopoll channel program is designed to run continuously, without inter- 
ruption, as long as Receive Ready (RA) or Receive Not Ready (RNR) responses flow. 
The Autopoll channel program is interrupted when SDLC supervisor frames or infor- 
mation frames are received, when data is to be transmitted, or when certain Pu 
services \/O has to be processed. In order to send the Write data, the Autopoll 
channel program is interrupted by changing the third ccw, which is a No-op, to a TIC 
Ccw pointing to the Write piu channel program. 


The Write buffers to be transmitted are pointed to by a pending queue (PUTPENDQ), 
or an error hold queue (PUTEHOLD), in the PUT entry. The SDLC station scheduler 
scans every PUT entry, starting from the current entry indicated in HALCUSCB, and 
passes the Write buffers to TSC’s SDLC channel program build routine. 


lf there is no Write data to be sent to any station, the Autopoll is restarted. The 
communication adapter begins polling from the next station in the station polling 
list unless the polling index is changed by the Set Mode ccw. One pass of the 
Autopoll channel program ts restarted if a Read Error ccw occurs on one of the 
Stations. This is accomplished by changing the Tic Ccw after the Autopoll ccw to a 
No-op. 
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vm vse I/O Scheduling for PU Services 
All pu services requests are processed by the SOLC connection manager outbound 
(ISTTSCHO) on the PU services PAB in the HALCB (NCBPUPAB). Before initiating 1/0 for PU 
services, a switch is set to wait for current i/o (including the Autopoll channel 
program) to finish. This is done by setting the state of PU services I/O (HALPUSIO) to 
pending, which signals the channel end not to restart application program I/O or 
Autopoll after the completion of the current 0. The continuous Autopoll channel 
program is broken by changing the third ccw, which is a No-op, to a TIC CCW 
pointing to another No-op. 


When the current 1/0 has been completed, the state of Pu services 1/0 is set to 
“halted,” and the connection manager processes the request and schedules 1/0. 
The state of pu services 1/0 changes to “active.” The state changes to “inactive” 
after the completion of i/o. 


The connection manager builds its channel program in a buffer (at TSCPCCW). 


vm vse 1/O Scheduling for the Link Level 2 Test 
A TESTMODE request is initiated and completed by the SpLC connection manager out- 
bound routine (ISTTSCHO) on the PU Services PAB in the HALCB (NCBPUPAB). The link 
level 2 test is executed by channel end and the link scheduler. 


If the TESTMODE request is to start a link level 2 test, the SDLC connection manager 
outbound routine sets the station to “test mode,” initializes fields in the PUT entry, 
obtains storage for the write and read buffers, moves the specified data into the 
write buffer, and starts the Write Test channel program. The Write Test channel 
program is repeated the specified number of times, or until the test is canceled by 
the operator. 


lf the TESTMODE request is to cancel a current test, a RECTR request is built and sent 
to network operator services to that the operator message with the test results can 
be built. 


vm vse Channel Programs 
The following channel programs are used in 1/0 sequences that send data to or 
receive data from devices on nonswitched and switched SDLC lines. 


Note: The Autopoll channel program (a part of the Write piu channel program) and 
the Sense scsB channel program are in the HALCB (HALCHPGM). The other channel 
programs are formatted in i/o buffers. 


vm vse Autopoll Channel Program 
The Autopoll channel program is used to solicit data from active stations (data poll) 
and to check whether inactive stations are ready to be activated (contact poll). 
When the Autopoll ccw is executed, the communication adapter steps through the 
SDLC polling list table (SPL table; scB table to the communication adapter) and 
sends either a data poll or a contact poll until one of the following occurs: 


e An active station responds with data. 
¢ An inactive station responds with a nonsequenced acknowledgment (NSA). 


e An error occurs. 
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¢ vTam changes the Tic address of point to a Write PIU channel program or to a 
No-op ccw to stop the Autopoll channel program. 


lf all responses to the polls are negative, the final Tic chains to the second ccw (the 
No-op) to start another poll pass through the spt table. 


Command 
Code 
(hex) Flags Description Remarks 


23 CC,SLI Sets the desired operating mode. Optional 
03 CC,SLI Required as the /ast in a chain. 


08 —_ When polling, transfers control to 
the Autopoll ccw immediately fol- 
lowing the Tic. For a Write 
channel program, either transfers 
to a string of Write Pius or to a 
No-Op ccw to stop Autopoll. (See 
the Write piu channel program.) 


Autopoll 


09 CC,SLI Starts polling, points to the SPL 
table, sends Receive Ready (RR) 
for data pol! or Set Normal 
Response Mode (SNRM) for 
contact poll depending upon the 
flag settings in the SPL. 


08 — Transfers back to the second 
command (No-Op) to continue 
polling, is changed to No-Op if 
continuous Autopoll is not 
required (for example, when an 
error occurs on a Read Ccw), and 
transfers to a Write Test channel 

- program when LL2 test is 
required. 


08 —_ is executed when status modified 
is given to the channel by the 
communication adapter and 
transfers to Read piu or Sense 
scB channel program. 
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vu vse Read PIU Channel Program 
The Read piu channel program reads data sent to vTAM by another SDLC station. 
Normally, the channel program is started when an Autopoll Tic points to the first 
Read piu buffer. The Read piu ccws are built in the buffers that will receive the data 
and are chained together by Tics. The number of buffers in the chain is determined 
by the values for the INBFRS operand of the line's definition statement. 


When vtaM is a secondary link station or when the line is in an inbound direction, 
the communication adapter starts the Read piu channel program with the Control 
ScCB CCW that is located in the HALCB. 


When the transmission is complete or when the communication adapter detects 
error information, the communication adapter skips over any remaining Read Plu 
ccws to a Sense ccw by which it can report error information. 


The Read Piu channel program is pointed to by the Autopoll channel program 
unless it starts with a control SCB Ccw. 


Command 
Code 
CCW (hex) Flags Description Remarks 
Control SCB 0B CC,SLI Used only when VTAMN is a Optional 
secondary link station, the 
line is in an inbound direc- 
tion, and the Autopoll 
channel program is not used 
to point to the first Read ccw 
in the HALCB. 
TIC 08 —_ Points to the first Read PIU in Optional 
the HALCB. 
Read PIU 06 CC,SLI Points to the input area. 
TIC 08 — Points to the next Read Piu 
CCW. 
Read PIU 06 CC,SLI Points to the input area. 
TIC 08 — Points to the Sense ScB CCW 


that is in the HALCB. 
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vm vse Write PIU Channel Program 
The Write piu channel program sends data to another SpLC station. Normally, the 
channel program is started when an Autopoll Tic points to the first Write piu buffer. 
The Write PIU ccws are built in the buffers that contain the outbound data. After the 
data in the last buffer is sent to the station, the program executes a Poll ccw that 
sends AR (Receive Ready) so that the station may acknowledge receipt of the data 
and, optionally, may send any waiting data. The final Tic points to the Read piu 
channel program in order to receive possible inbound data and to verify that the 
outbound data was received. 


The Write piu channel program is pointed to by the Autopoll channel program in the 


HALCB. 
Command 
Code 

CCW (hex) Flags Description 

Control SCB 0B CC,SLI Points to an SPL entry. 

TIC 08 — Points to the first Write Piu in the HALCB. 

Write PIU 05 cc Points to the buffer containing the Piu to 
be sent. Even when the data is spanned 
in more than one buffer, the ccws are 
command chained. 

TIC 08 — Points to a Write piu Ccw if there are 
more Pius, or points to a Poll Ccw if the 
last PiU has been sent. 

Poll OF CC,SLI Starts polling at the next entry in the SPL. 

TIC 08 — Points to a Read Plu or Sense SCB CCw. 
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The Write Test channel program sends and receives test frames. It is used when a 
link level 2 test is requested. The Write Test channel program is pointed to by the 
Autopoll channel program or by NCBCAw in the HALCB. 


aw a SS SS 


Command 

Code 
CCW (hex) Flags Description 
Write 01 CC,SLI Points to data in the Write buffer. 
Read 02 SLI Points to the Read buffer. 


va vse Sense SCB Channel Program 


The Sense scs channel program is used to retrieve completion status from the 
communication adapter. The Sense scs ccw is the last ccw in the chain for channel 
programs that perform normal! data transfer for the Autopoll channel program, the 
Read piu channel program, or the Write SDLC Control channel program. 


Command 

Code 
CCW (hex) Flags 
Sense CCB 14 SLI 


vm vse Sense I/O Channel Program 


Description 


Points to an input area (HALCUSCB). 


The Sense vo channel program requests and receives line configuration informa- 
tion from the communication adapter. This information is used to verify informa- 
tion in the line’s definition statement. The verified information is included in the 
line’s OBR record for the line. For this channel program, the HALLFSM field of the 


HALCB is set to X'01'. 


Command 

Code 
CCW (hex) Flags 
Sense |/O E4 — 
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Description 


Points to an input area used to obtain the 
line configuration. 
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vm vse Enable Line Channel Program 


The Enable Line channel program is used when a nonswitched line is activated. 
When this channel program is being executed, the HALLFSM field in the HALCB is set 


Description 


Sets the line to disable state and clears 
certain pending status conditions. 


Tells the communication adapter how 
VTAM expects to use the line and sets 
operating values such as timeout values 
and control indices. Desired operating 
mode values are contained in the 
HALSMODE field in the HALCB. 


to X'02'. 

Command 

Code 
CCW (hex) Flags 
Disable 2F CC,SLI 
Set Mode 23 CC,SLI 
Enable 27 SLI 


Causes the communication adapter to 
make the DCE interface ready. For ccitT 
V.24 Or EIA RS-232C, Enable means acti- 
vating the Data Terminal Ready (DTR) line 
and verifying that the response is Data 
Set Ready (psp). 


a 
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vu vse Answer Channel Program 


550 ~=VTAM Diagnosis 


The Answer channel program is used when a switched line is activated. When a 
call is received, vTAM checks information in the xiD response against values in the 
corresponding switched line's definition statement. Based on that information, 
VTAM either accepts or rejects the call. For this channel program, the HALLFSM field 


in the HALCB is set to X'01'. 


Command 
Code 
CCW (hex) Flags Description 


Disable 2F CC,SLI Sets the line to disable state, clears 
certain pending status conditions, and 
breaks any outstanding switched con- 
nections. 


Set Mode 23 CC,SLI Tells the communication adapter how 
VTAM expects to use the line and sets 
operating values such as control indices. 
The desired operating mode is contained 
in the HALSMODE field in the HALCB. 


Enable 27 CC,SLI Causes the communication adapter to 
make the ocE interface ready. This ccw 
is not completed until an incoming call is 
accepted, so it may be active for a long 
time before it completes with the Data 
Terminal Ready (DTR) sequence. 


Write 01 CC,SLI Points to the area containing all station 


identifiers and xi0 commands (TSCODATA). 


Read 02 SLI Points to an input area (TSCIDATA). 
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vm vse Dial Channel Program 
The Dial channel program is identical to the Answer channel program except that a 
Dial ccw is used to initiate an outbound call (an Enable ccw is used to receive an 
inbound call). Execution of the Dial ccw transfer the desired telephone number to 
the communication adapter which forwards the number, one digit at a time, to an 
autocall adapter. The HALLFSM field in the HaLcs is set to X'02' when this program 


is active. 
Command 
Code 
CCW (hex) Flags Description 
Disable 2F CC,SLI Sets the line to disabled state. 
Set Mode 23 CC,SLI Sets the desired operating mode as spec- 
ified im HALSMODE. 
Dial 29 CC,SLI Points to an area (TSCPDATA) containing 
the digits to be dialed. 
Write 01 CC,SLI_ _—_— Points to the area containing all station 
identifiers and xID commands (TSCODATA). 
Read 02 SLI Points to an input area (TSCIDATA). 


vm vse Write SDLC Control Channel Program 
The Write soLC Control channel program is used when TAM is the secondary station 
(for example, as in a VTAM-NCP connection). This channel program sends a nonse- 
quenced acknowledgment (NSA) in response to a Set Normal Response Mode 
(SNRM) from a Contact Poll or in response to a Discontact (DISC) sent during shut- 
down processing. 


Command 
Code 

CCW (hex) Flags Description 

Set Mode 23 CC,SLI Sets the desired operating mode. 

Write 01 CC,SLI Points to an output area (TSCODATA) and 
will be changed to a No-Op ccw when 
closedown recording is required for the 
physical unit. 

TIC 08 _ Transfers to the Sense scs ccw that is in 


the HALCB, Causing the communication 
adapter to wait for some transmission 
from the primary station. 
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vm vse Read SDLC Control Channel Program 
Like the Write soLc Control channel program, the Read spLc Control channel 
program is used when vtTan is the secondary station. It waits for the Set Normal 
Response Mode (SNRM) sent by the primary station on a Contact Poll. 


The Read spLc contro! program can be pointed to by the Enable Line channel 


program. 
Command 
Code 
CCW (hex) Flags Description 
Set Mode 23 CC,SL! Sets the desired operating mode in the 
HALSMODE field in the HALCB. It can be a 
Write ccw or No-Op ccw, if required. 
Read 02 — Reads an SDLC command. 


vm vse Disable Line Channel Program 
The Disable Line channel program sends a Disable ccw to shutdown the modem 
interface of the communication adapter. 


Command 
Code 
CCW (hex) Flags Description 
Disable 2F SLI Sets the line to disabled state. 


vm vse Primary XID Channel Program 
The Primary xiD channel program is for a communication adapter-attached type 5 
physical unit (xiD Exchange). 


Command Contents 
Code of Address 
CCW (hex) Flags Description Field 
Set Mode 23 CC,SLI Changes the timeout HALSMODE 
value. 
Write 01 CC,SLI Transfers the xib(00) Output Area 


from this host to the 
communication 
adapter-attached host. 


Read 02 SLI Reads an SDLC Input Area 
command. 
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vi vse Secondary XID Channel Program 


The Secondary xiD channel program is for a communication-adapter-attached type 


4 physical unit (xip Exchange). 


Command 
Code 
CCW (hex) Flags 


Disable 2F CC,SLI 


Set Mode 23 CC,SLI 


Enable 27 CC,SLI 


Contents 
of Address 
Description Field 


Makes sure that the —_ 
line direction is out- 
bound. 


Changes the timeout HALSMODE 


value. 


Causes the communi- 
cation adapter to make 
the DCE interface 
ready. For ccitT v.24 
or EIA RS-232C, Enable 
means activating the 
Data Terminal Ready 
(DTR) line and verifying 
that the response is 
Data Set Ready (DsR). 


Read 02 SLI 


Reads an SDLC Input Area 


command. 
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va vseLink, Connection, and Physical Unit Finite State Machines 
If an error occurs during the activation or deactivation of the SDLC link or of a phys- 
ical unit, the finite state machines can be used to determine the state of the link or 
station. 


vm vseLink State Machine Values 
00 Reset 


01 Sense i/o pending 

02 Enable pending 

08 Active 

10 Halt vo pending 

20 DACTLINK disable pending 
30 INOP disable pending 


40 ACTLINK disable pending 


vm vseEConnection State Machine Values 
OO Reset 


01 Answer pending 

02 Auto dial pending 

04 Manual dial pending 
08 Connected 

10 Abandon Connection 1 
11. Abandon Connection 2 
21  DACTCONNIN pending 


41. Abandon Connect Out pending 


vm vsePhysical Unit State Machine Values 
0O Reset 


01 Contact pending 

03 Pending Discontact pending 

04 xID pending 

10 Active 

11 Test Mode 

21 Request Discontact (RQD) received 
22 Discontact pending 

23 Pending reset 

31 Secondary Contact pending 

32 Secondary Set Normal Response Mode (SNRM) received 
39 Primary/Secondary contention 


40 Secondary active 
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51 Secondary Discontact pending 
56 OBR pending INOP 
58 OBR pending Contacted 


60 OBR pending Discontact 


vm vse Hints for Common Errors: Finite States 
If an error occurs, the finite state in the PUT (PUTFSM) and in the HALCB (HALFSM) 
should be checked to find the state at which the error occurred. The finite state 
machine diagrams below show the actions occurring as a result of various inputs 
for the finite state machine values. 


The SCx in HALCB (HALCUSCB) contains the status for the last physical unit for which 
/O was active. 


The sense field in HALCB (NCBSENSE) Contains the sense data as a result of a unit 
check on the line. 


The state of PU services 1/0 (HALPUSIO) indicates whether or not the connection 
manager was doing I/O. 


The NCBPOLL flag, if on, indicates that the line is polling. If off, it indicates that 
either Write 1/0 or connection manager I/O is in progress. 


The NCBREADY flag, if on, indicates that the link is active. 
NCBLINOP indicates a permanent link error. 


NCBSINOP indicates a permanent station error. 
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va vse SDLC Finite State Machines 


556  VTAM Diagnosis 


The finite state machine diagrams (Figure 90 on page 557 through Figure 93 on 
page 560) show how vtTam handles Pu services requests and responses for its SOLC 
support. The requests shown are as follows: 


PU Services 

Request State Diagram 

ABCONN Connection (Figure 91 on page 558) 

ABCONNOUT Connection (Figure 91 on page 558) 

ACTCONNIN Connection (Figure 91 on page 558) 

ACTLINK Line (Figure 90 on page 557) 

CONNOUT Connection (Figure 91 on page 558) 

CONTACT Station (Figure 92 on page 559 and Figure 93 on 
page 560) 

DACTCONNIN Connection (Figure 91 on page 558) 

DACTLINK Line (Figure 90 on page 557) 

DISCONTACT Station (Figure 92 on page 559 and Figure 93 on 
page 560) 

TESTMODE Station (Figure 92 on page 559) 


The diagrams show the following: 
e The request or event (above the line). 


¢ The action taken (under the line). For example, a channel program generated 
or the response given to PU services as a result of the event. 


e The transition (direction of the line) to the next state. 
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Figure 90. VM VSELine Finite State Machine 
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Figure 91. VM VSE Connection Finite State Machine 


558 ~VTAM Diagnosis 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


SECONDARY SECONDARY 

CONTACT SNRM SECONDARY DISCONTACT 
RESET PENDING RECEIVED ACTIVE PENDING 
CONTACT SNRM S or | FRAME DISCONTACT DISC 


+RSP(CONTACT) | WRITE NSA CP 
READ CP 


CONTACTED (LOADED) 
AUTOPOLL CP 


STOP AUTOPOLL 
NSA CP 


WRITE UA(NSA) CP 
+RSP(DISCONTACT) 


TEST 


WRITE TEST CP 


SNRM SNRM 


INOP(05) 


WRITE RD 
(RQD) CP 


S or | Frame S or | Frames S or | Frame 


DM 
Discard data 


DISCONTACT 


RO(RQD) 
Discard Data 


UC (02C7) 


HIO SVC DISCONTACT 


STOP AUTOPOLL 
DISC 
WRITE OM CP 

DISC 


INOP (03) 
WRITE UA(NSA) CP 
INOP(03) 


WRITE UA(NSA) CP 
INOP(03) 


Temporary Error 


Permanent Error 


CONTACTED(ERROR) 


Temporary Error Temporary Error 


Permanent Error 


CONTACTED(ERROR) 


Permanent Error 


-RSP(DISCONTACT, 
800D),INOP(01) 


X1ID(00), 
Parms OK 


WRITE X10(07) CP 


RESET FROM 
LINE 


XID(O0), 
Parms no good 


WRITE XID(07) 
(ERROR STATUS), 
CONTACTED (05) 

(XID ERROR) 


X1D(07) 
(ERROR STATUS) 


CONTACTED(05) 
(XID ERROR) 


Figure 92. VM VSE Secondary Station Finite State Machine 
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Figure 93. VMVSE Primary Station Finite State Machine 
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Appendix Cc. Network k Flows 


This appendix describes the flow of vTAM RUS and AMRUS between network address- 
able units, first single network flows and then cross-network flows. The diagrams 
are divided into the following categories: 


e Activation 

¢ Session Establishment 

¢ Deactivation and Session Termination 

e Error Recovery Processing (ERP) and Management Services 


For certain session establishment RUs (ACTCDAM, ACTPU, ACTLU, and BIND), additional 
Rus can flow if the explicit route (ER) or virtual route (vA) selected for a session is 
not active. Because this flow is essentially the same for all four RUs, these RUs are 
referred to as generic bind (GBIND) AMRUS. To avoid repetition, the flows for these 
AMRUS are shown once at the beginning of this appendix. 
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Single Network Flows 


Activation Flows 
GBIND AMRuUs: Figure 94 on page 566 through Figure 97 on page 567 show the 
flow of requests and responses between the sscp and logical and physical units 
when a VR or ER Selected for a session is not yet active. 


¢ Sending an AcTPu request for a communication controller or physical unit 
(Figure 94 on page 566) 


¢ Sending an ACTLU request for a logical unit (Lu; Figure 95 on page 566) 


¢ Sending a BIND request to a secondary logical unit (Stu; Figure 96 on 
page 567) 


¢ Activating a virtual route (Figure 97 on page 567) 
Resource Activation: Figure 98 on page 568 through Figure 113 on page 581 


show the flow of requests and responses between the sscp and logical and phys- 
ical units to activate resources. 


e Activating an NCP major node (Figure 98 on page 568 and Figure 99 on 
page 569) 


¢ Activating the resources controlled by a host or ncp major node (Figure 100 on 
page 570 through Figure 111 0n page 580) 


¢ Takeover of a Type 2.1 peripheral node logical unit (Figure 101 on page 5771) 


— Activating a connection to a host or ncp (Figure 100 on page 570 through 
Figure 104 on page 574) 


— Activating a physical unit (Figure 105 on page 575 and Figure 106 on 
page 575) 


— Moving the address of a physical unit (Figure 105 on page 575, Figure 107 
on page 577, and Figure 108 on page 578) 


— Takeover of a 12.1 Node logical unit upon physical unit activation 
(Figure 109) 


— Activating a logical unit (Figure 110 on page 580 and Figure 111 on 
page 580) 


— Activating an application program/Opening an Acs (Figure 111) 


¢ Activating a CDRM (Figure 112 on page 581 and Figure 113 on page 581) 


Session Establishment Flows 


Figure 114 0n page 582 through Figure 128 on page 595 show the flow of requests 
and responses between the sscp and logical and physical units to establish ses- 
sions. 


¢ Requests initiated by primary logical units (PLus) (Figure 114 0n page 582 
through Figure 117 on page 585) 


¢ An independent PLU-initiated request for LU-LU session establishment 
(Figure 118 on page 586) 
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A PLu-initiated request for LU-LU session establishment with an independent sLu 
(Figure 119 on page 587) 


SLu-initiated requests (Figure 120 on page 588 through Figure 123 on 
page 590) 


An independent stu-initiated request for Lu-LU session establishment with a PLU 
(Figure 124 on page 591) 


Third party-initiated requests (Figure 125 on page 592 and Figure 126 on 
page 593) 


VARY LOGON Of LOGAPPL processing (Figure 127 on page 594) 


Notification of PLU Availability (Figure 128 on page 595) 


Deactivation and Termination Flows 
Figure 129 on page 596 through Figure 138 on page 604 show the flow of requests 
and responses between the sscp and logical! and physical units to deactivate 
resources and end sessions. 


Deactivating a logical unit (Figure 129 on page 596 and Figure 130 on 
page 596) 


Deactivating a logical unit with giveback (Figure 131 on page 597) 

VARY TERM processing (Figure 132 on page 598 and Figure 133 on page 599) 
CLOSE ACB processing (Figure 134 on page 600) 

Deactivating an application program (Figure 135 on page 601) 


Deactivating a corm (Figure 136 on page 602 through Figure 138 on page 604) 


ERP and Management Services Flows 
Figure 139 on page 605 through Figure 141 on page 606 show the flow of requests 
and responses between the sscp and logical! and physical units to handie error 
recovery processing (ERP) and route Forward and Deliver Rus. 


* ERP processing (Figure 139 on page 605 and Figure 140 on page 606) 
¢ sscP management services processing (Figure 141 on page 606) 
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Se ee ee 
uvs vy Cross-Network Flows 


uvs vu Activation Flows 
Figure 142 on page 607 through Figure 144 on page 609 show the flow of requests 


and responses activating a cross-network SSCP-SSCP Session. 


¢ Gateway sscp requests session (Figure 142 on page 607) 
e Non-gateway sscp requests a session (Figure 143 on page 608) 
e Back-to-back gateway NCPs request a session (Figure 144 on page 609) 


uvs vu session Establishment Flows 
Figure 145 on page 610 through Figure 164 on page 631 show the flow of 
requests and responses to establish a cross-network LU-LU session. 


¢ SLu-initiated request for single gateway sscp and single gateway NCP 
(Figure 145 on page 610) 


* PLU-initiated request for single gateway sscp and single gateway NCP 
(Figure 147 on page 612) 


e Independent PLuU-initiated request for single gateway sscPp and single gateway 
NcP (Figure 149 on page 614) 


¢ PLU-initiated request setup queued for single gateway sscP and single gateway 
ncP (Figure 150 on page 615) 


* SLU-initiated request for a single gateway connecting three or more networks 
(Figure 152 on page 617) 


e Default partitioning of gateway sscp responsibility spanning three networks 
(Figure 153 on page 618) 


* SLU-initiated request for predesignated control of gateway NcPp by middle host 
(Figure 154 on page 619) 


¢ Multiple gateway sscps and back-to-back gateway NcPs (Figure 156 on 
page 623) 


e Third-party-initiated request spanning three networks (Figure 157 on 
page 624) 


¢ Initiate with VARY LOGON or Controlling PLU for single gateway sscp and single 
gateway ncP (Figure 158 on page 625) 


¢ sLu-initiated session initiation failure (CDINIT rejection) for single gateway SscP 
and single gateway ncp (Figure 160 on page 627) 


* SLU-initiated session initiation failure (SETcv failure) for single gateway SSCP 
and single gateway NcP (Figure 162 on page 629) 


* sSLU-initiated setup procedure failure (CINIT rejection) for single gateway SSCP 
and single gateway NcP (Figure 164 on page 631) 
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mvs vmDeactivation and Termination Flows 
Figure 166 on page 633 through Figure 178 on page 644 show the flow of requests 
and responses to deactivate resources and end sessions. 


¢ PLU Sends UNBIND for single gateway sscp and single gateway ncpP (Figure 166 
on page 633) 


¢ Independent PLU sends UNBIND for independent su (Figure 167 on page 633) 
¢ Independent PLU sends CLEANUP for independent sLu (Figure 168 on page 634) 


¢ SLU requests Terminate Self for single gateway sscp and single gateway NCP 
(Figure 169 on page 635) 


¢ sLU requests Terminate Self (Cleanup Option) for single gateway sscp and 
single gateway ncp (Figure 170 on page 636) 


¢ PLU Sends UNBIND for multiple gateway sscPs and a single gateway NCP 
(Figure 172 on page 638) 


e SLU requests Terminate Self for multiple gateway sscrs and back-to-back 
gateway NcPs (Figure 173 on page 639) 


e Terminating an sscP-sscP session (Figure 174 on page 640) 


¢ Terminating an Lu-LU session between two independent Lus (Figure 175 on 
page 641) 


e Route failure causes session termination (Figure 176 on page 642) 


e Route failure causes session termination for multiple gateway sscps and back- 
to-back gateway NcPs (Figure 178 on page 644) 
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Figure 94. Session Activation: ACTPU. 


* The ACTPU may flow either to the communication controller or to a physical 
unit. 
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Figure 95. Session Activation: ACTLU 


566 VTAM Diagnosis LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


“Restricted Materials of IBM" 
Licensed Materials — Property of IBM 


PUS of PUS of 
PLU PLU SLU SLU 


GBIND (BIND) 


ER_ACT_REPLY 
ACTVR 


+RESP (VRPRS) 
Isolated VRPRS 
+RESP es 


Figure 96. Session Activation: BIND 
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Figure 97. Activating a Virtual Route and the Associated Explicit Route 
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Figure 98. Activating a Channel-Attached Communication Controller. 
1 Includes NCP Dynamic Path Definition capability indicator in V3R2. 


2 Flows only for Dynamic Path Definition in V3R2. 
SETCV and IST929I flow for each Dynamic Path Definition Member specified. 
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Figure 99. Activating a Link-Attached Communication Controller. 
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+ Includes NCP Dynamic Path Definition capability indicator in V3R2. 


2 Flows only for Dynamic Path Definition in V3R2. 


SETCV and IST929I flow for each Dynamic Path Definition Member specified. 
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Figure 100. Activating a Link (ACTLINK) 
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Figure 101. Activating a Switched Link with Takeover. 


1 SETCV does not flow for NCPs that support peripheral nodes. 
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Figure 102. Activating a Cross-Subarea Link Station 
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Figure 103. Establishing Contact with a Channel-Attached Host 
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Figure 104. Establishing a Switched Connection. To establish a switched connection, the 
SSCP sends an Active Link request to indicate that the link is active. An 
Active Connect In request is sent to enable the communication controller to 
answer incoming calls. (Instead of Activate Connect In, Dial could be sent to 
initiate an outbound call.) When a cali comes in, the communication con- 
troller sends an XID (exchange identification) and the physical unit responds 
with its !D (station address). The communication controller sends a Request 
Contact (Offhook) request to the SSCP. The SSCP sends a Set Control Vector 
request containing address and pacing information to the communication con- 
troller. The standard activation sequence then occurs (see Figure 99 on 
page 569). 
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Figure 105. Activating a Type 2 Physical Unit 


Note: If the physical unit must be loaded, additional Rus will flow. See Figure 106 
for more information. 
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Figure 106. Activating a Type 2 Physical Unit with Load Required 
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This figure shows only the rus that flow when a type 2 physical unit requires 
loading. For the rus that flow before and after those in this figure, see Figure 105. 


Some devices, such as the 18M 8775, may require loading. During activation of the 
physical unit, the request for load is indicated in the acTPu response. (Following 
activation, the physical unit may request loading with an NS_LDREQD RU.) 


The sscp formats the load request into a network services (NS) RU to initiate the 
load. The management services subcomponent of the sscp then sends the 
embedded request to the physica! unit load program of the Downstream Load 
Utility. 


If the physical unit load program is not available, it sends a negative response to 
the sscp’s Deliver RU. The sscp then sends an NS_IPL_ABORT RU to the physical unit 
for deactivation processing. (If the load was requested with an NS_LDREQD Ru, the 
physical unit is not deactivated; in fact, it may try the load request again.) 


If the physical unit load program is available, it sends a positive response to the 


sscp’s Deliver RU. The load program then sends a forward Ru, containing an 
NS_LOADSTAT RU, to relay the status of the load operation. 
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Figure 107. Moving a SYSGENned Physical Unit. 


1 RNAA flow is as normal. RNAA 
TYPE = MOVE, ACT=NO. 
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SSCP 
OPERATOR Configuration SSCP 
CONSOLE Services SYSDEF NCP 
VARY OROS or 
MODIFY DR, 
TYPE=MOVE, 
ACT=YES 


VARY COMMAND 
(MOVE) 


(Sysdef moves 
RDTE of PU) 


IST6701-VARY 
PROCESSING 
COMPLETE FOR 
(nodename) 

or 
1IST2411 COMMAND 


COMPLETE FOR 
(nodename) 


VARY ACT 
COMMAND 
RNAA (add) ? 


ee + RESP(RNAA) 
So CONTACT 


Figure 108. Moving a Dynamically Added Physical Unit. 


1, RNAA flow is as normal. RNAA does not flow for MODIFY OR, 
TYPE = MOVE, ACT=NO. 
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Ce Te 


OPERATOR SSCP1 SSCP2 PU BF PN 


ACTPU 


ACTPU 
ACTPU 
ACTLINK 


vaconce | gs 


+ RESP 
CONTACT 


+RESP (CONTACT) 


XID Exchange 


- S 


+RSP(ACTLU) 2 


ACTPU 


+RESP 
ACTLU (erp 


Figure 109. SSCP Takeover of Peripheral! Node Logical Units. 
1 Independent logical unit only. 
2 Dependent logical unit only. 


Note: The following conditions are assumed for this example: 


e The physical units being taken over are defined with ANS=CONTINUE, specifying 
that any Lu-LU sessions that are active at sscp-takeover time will! continue. 


e There are some Lu-LU sessions active at failure time under the physical unit 
being taken over. 
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Operator's Communication 
Coneala SSCP Controller PU LU 


V NET.ACT, 
ID=LU name 


Message 


ISTO931,_ 


Figure 110. Activating a Logical Unit 


Operator’s 
Console SSCP PUNS LU Services OPEN/CLOSE EU 
V NET,ACT, 


ID=aPpPL 


Message 
ISTO931, , 
Node Active 


OPEN ACB 
OPEN ACB AMRU 
ADONR 
+RESP 
i eee 
+RESP 
+RESP 
+RESP 


Figure 111. Activating an Application Program/Processing an OPEN ACB Request. 
' These do not flow for OPEN ACB processing. 
7 PUNS cannot send a response to the OPEN ACB request unti! LUS receives an ACTLU request for the 


. application program. Therefore, PUNS issues CPWAIT and waits for LUS to post it. Once LUS has 
received the ACTLU, it posts PUNS, which then sends a response to the OPEN ACB request. 
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Operator's 
Console SSCP1 SSCP2 


V_NET,ACT,ID=SSCP2 


ACTCDRM (ERP) 


+RESP (ERP) 


Terminate migration 
user sessions 


Terminate migration 
user sessions 


Message 1S0931,Node Active 


Figure 112. Activate CDRM with ERP Response 


Operator's 
Console SSCP1 SSCP2 


V NET,ACT,ID=SSCP2 


ACTCDRM (ERP) 


+RESP (COLD) 


Terminate all 
user sessions 


Terminate migration 
user sessions 


+RESP 


Message !S0931,Node Active 


Figure 113. Activate CORM with COLD Response 
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Figure 114. Primary Logical Unit Initiate (OPNOST Acquire) 
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Figure 115. Primary Logical Unit Initiate (SIMLOGON). 
* LOGON EXIT and OPNDST ACC flow only when the PLU is associated with an application program. It 


does not appear in the flow if the PLU is a device-type logical unit. This is true for many following flows 
with LOGON EXIT and OPNDST ACC. 
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Figure 116. Primary Logical Unit initiate (SIMLOGON(RELREQ)) 


SCIP EXIT 
OPNSEC 


RELREQ 
EXIT. 
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SIMLOGON 
INITIATE 
+RESP 
+RESP 
+RESP 
Se COCINIT 
CINIT 
SIMLOGON 


LOGON EXIT ia | 
RELREQ 
INITIATE 
CDINIT 
P| erese(aw) | 
NOTIFY* +RESP (Qd) 
NOTIFY +RESP (Qd) 
OPNDST ACC 
+RESP 
SCIP EXIT 


SESSST SESSST 
CDOSESSST 
SS 
SCIP EXIT 


+RESP 


= = 
NOTIFY* 
NOTIFY* 
RELREQ 
EXIT* 


Figure 117. Primary Logical Unit Initiate (SIMLOGON(RELREQ))(Session is Pending Active or Already in 
Progress). 


* If the session is pending active, the NOTIFY request and the RELREQ EXIT request flow after the 


response to the CDINIT request from PLU2’s SSCP. If the session is already in progress, these requests 
flow after the response to the OPNDST ACC. 
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NCP NCP 
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Figure 118. Independent PLU-Initiated Cross-Domain Session Initiation with Independent 
SLU. 


*“ RNAA flows only if the network address is needed. 
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Figure 119. PLU-Initiated Cross-Domain Session Initiation with Independent SLU. 


* RNAA flows only if the network address is needed. 
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Figure 120. Secondary Logical Unit Initiate (LOGON) 
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Figure 121. Secondary Logical Unit Initiate (REQSESS) 
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+RESP 


| COCINIT 

LOGON EXIT +RESP 
OPNDST ACC 
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(End User). ) 
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SESSST 


Figure 122. Secondary Logical Unit Initiate (INIT SELF) 


sscpe 


EIT TE, 


SSCP Request Unformatted 
Processor System Services Logical Unit 


Character-Coded 
Logon or Logoff 


Initiate or Terminate 


+RESP 


+RESP 


Character- Coded 
Message 


+RESP 


Figure 123. Sending an Unformatted Request to the SSCP 


In this example, the logical unit sends a character-coded Jogon or logoff to the 
sscp. The unformatted system services portion of sscp converts the logon into a 
field-formatted Initiate Self or Terminate Self request. The request is then passed 
to the sscp request processor. 


If the return code indicates an unsuccessful transmission, the unformatted system 


services portion of sScP converts the request into a form that can be understood by 
the terminal logical unit. 
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Figure 124. Dependent SLU-Initiated Cross-Domain Session Initiation with Application LU 
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Figure 125. Third Party Initiate (CLSDST PASS). 
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1 V3R2 only 
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Figure 126. Third Party Initiate (CLSDST PASS with NOTIFY) 
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VARY NET,LOGON 
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when SLU is 

a dial device +RESP 
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+RESP 
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Figure 127. VARY NET,LOGON or LOGAPPL. 


+RESP 


SESSST 


CDSESSST 
+RESP 
SOT 


+RESP 


* This applies only when the PLU is associated with an application program. It does not appear in the 
flow if the PLU is a device-type logical unit. 
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Figure 128. Notification of PLU Availability. 


* This applies only when the PLU is associated with an application program. 
It does not appear in the flow if the PLU is a device-type logical unit. 
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Figure 129. Deactivating a Logical Unit (Immediate). 


+RESP° 


* These flow only when the operator activates a specific logical unit. For example, they do not flow 
during immediate deactivation of a CDRM. 


Operator's SSCP Configuration SSCP Session 

Console Service Service SLU SSCP of PLU PLU EU 
V NET,INACT, 
ID=LU name,F° 


TERM OTHER(C) 


COTERM(C) 
CLEANUP 
+RESP NSEXIT 
_—se 
+RESP 


Figure 130. Deactivating a Logical Unit (Forced). 


* These flow only when the operator deactivates a specific logical unit. For example, they do not flow 
during forced deactivation of a CDRM. 
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OPERATOR’S SESSION CONFIGURATION 
CONSOLE SERVICES SERVICES NCP 


VNET 
INACT, 
ID=LINK, G 


DACTLINK(G) 


TERM OTHER ! 
(QUEUED/PENDING 
SESSIONS) 


SWAP ACTIVE SESSIONS 
FROM LU TO CDRSC 


NOTIFY 2 


IST1051 
Node Inactive 


Figure 131. Deactivating a Logical Unit with Giveback. 


!‘ The DACTLINK X'02' disconnects only queued and pending LU-LU sessions. 
Active LU-LU sessions remain active. 


2 After session services transfers SIBs of ACTIVE logical units to the CDRSC, 
configuration services SRT ADDs the CDRSCs as real resources, and the 
logical units are ADDed as shadow resources. If a CDRSC for a particular 
logical unit does not exist, a dynamic CDRSC is allocated for the logical unit. 
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Figure 132. VARY NET,TERM Unconditional 
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Figure 133. VARY NET,TERM Cleanup 
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Configuration Session 
EU OPEN/CLOSE LUS PUS Services Tsc Services 


CLOSE ACB AMRU 
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| termine er 
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CPPOST (1) 
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DELETENR 
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Figure 134. CLOSE ACB Processing. 
1 The repetition of flows shown here indicates multiple sessions. 


? PUNS cannot send a response to the CLOSE ACB AMRU until DACTLU processing is complete and the 
LUCB and FMCB for the application program have been deleted. Therefore, after requesting that contig- 
uration services deactivate the logical unit, PUNS issues CPWAIT and waits for LUS to post it when the 
logical unit has been deactivated. Once it is posted, PUNS waits to be notified that there are no more 
active sessions for the application program. It issues CPWAIT (1) and waits for configuration services to 
send a request to delete the FMCB. PUNS posts itself when it has processed each of these requests and: 
sends a response to configuration services to notify it that the LUCB has been deleted. After sending 
this response, PUNS sends a response to the CLOSE ACB AMRU. 
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Figure 135. Deactivating an Application Program. 


DELETENR 


VTAM 
Operator 


SSCP TSC 


V NET. INACT,ID=APPL 


Message 1ST1051, 
Node Now Inactive 


*" PUNS cannot send a response to the CLOSE ACB AMRU until there are no more active sessions for the 


application program. Therefore, after the SSCP sends a request to delete the FMCB, PUNS issues 
CPWAIT (1) and waits for OPEN/CLOSE to send ita CLOSE ACB AMRU. Once it has received this 


request, PUNS issues CPWAIT (2) and waits for TSC to send a request to delete the LUCB. PUNS posts 
itself when it has deleted the FMCB and sends a response to configuration services, then posts itself 


when it has deleted the LUCB. After posting itself the second time, PUNS sends a response to the 


CLOSE ACB AMRU. 
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sessions 
terminated* 
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Node Now 
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Figure 136. Deactivating a CDRM - Normal. 


* Session services purges the queues of user session requests. Since this 
processing is internal to session services, no RUs flow between components. 


Note: When the CDRM is actually deactivated, immediate processing takes 
place. See Figure 137 on page 603 for the RUs that flow for immediate deac- 
tivation of a CDRM. 
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Figure 137. Deactivating a CDRM - immediate. 


* See Figure 129 on page 596 for deactivate immediate processing for a 


logical unit. 
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Figure 138. Deactivating a CDRM - Forced. 


* See Figure 130 on page 596 for deactivate (force) processing for a logical 
unit. 
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Figure 139. Error Recovery Processing - Soft INOP. 


as NSEXIT 
or 
LOSTERM 
CLSDST? 
2 


LU 
Services PLU 


CLEANUP 


1 If the NSEXIT exit routine is scheduled, LUS cleans up the session and sends a positive response to the | 
cleanup request. If the LOSTERM exit routine is scheduled, LUS does not clean up the session, and it 


sends a negative response to the cleanup request. 


2 These flow only if the LOSTERM exit routine is scheduled. 
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Figure 140. Error Recovery Processing - Hard INOP. 


1 If the NSEXIT exit routine is scheduled, LUS cleans up the session and sends a positive response to the 
cleanup request. If the LOSTERM exit routine is scheduled, LUS does not clean up the session, and it 


sends a negative response to the cleanup request. 


? These flow only if the LOSTERM exit routine is scheduled. 


CNM SLU SSCP PU 


FORWARD (RU,)! 
RU, 
+RESP (RU_) 


-— a 


DELIVER (RU,) 
+RESP (RU,) 


+RESP (DELIVER) 


Figure 141. FORWARD and DELIVER Routing. 
1 RUx is a maintenance service RU. 


2 Either RUy contains data in reply to RUx, or it is an unsolicited RU. 
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Figure 142. mvs vMActivating a Cross-Network SSCP-SSCP Session: GWSSCP Requests 
Session 
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Figure 143. mvs vMActivating a Cross-Network SSCP-SSCP Session: Non-GWSSCP 


Requests Session 
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Figure 144. MVS VMActivating a Cross-Network SSCP-SSCP Session: Back-to-Back GWNCPs Request Sessions 
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Figure 145. MVS VM Establishing a Cross-Network LU-LU Session: SLU-Initiated Request for Single GWSSCP and 


Single GWNCP (Pre-V3R2) 
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Figure 146. MVS VM Establishing a Cross-Network LU-LU Session: SLU-Initiated Request for Single GWSSCP and 
Single GWNCP (V3R2) 
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Figure 147. MVS VM Establishing a Cross-Network LU-LU Session: PLU-Initiated Request for Single GWSSCP and 


Single GWNCP (Pre-V3R2). 


Note: Session setup continues as in the flow for an SLU-initiated session. 
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Figure 148. MVS VM Establishing a Cross-Network LU-LU Session: PLU-Initiated Request for Single GWSSCP and 


Single GWNCP (V3R2). 


Note: Session setup continues as in the flow for an SLU-initiated session. 
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Figure 149. MVS VM Establishing a Cross-Network LU-LU Session: Independent PLU Request for Single GWNCP with 
an Independent SLU. 


* RNAA flows only if the network address is needed. 
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Figure 150. MVS VM Establishing a Cross-Network LU-LU Session: PLU-Initiated Request Setup Queued for Single 
GWSSCP/Single GWNCP (Pre-V3R2). 


Note: Session setup continues as in the flow for an SLU-initiated session. 


“ Names only sent conditionally. 
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Figure 151. MVS VM Establishing a Cross-Network LU-LU Session: PLU-Initiated Request Setup Queued for Single 
GWSSCP/Single GWNCP (V3R2). 


Note: Session setup continues as in the flow for an SLU-initiated session. 


”" Names only sent conditionally. 
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Figure 152. MVS VM Establishing a Cross-Network LU-LU Session: SLU-Initiated Request for Single Gateway Con- 
necting Three or More Networks 
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Figure 153. MVS VM Establishing a Cross-Network LU-LU Session: Default Partitioning of GWSSCP Responsibility 
Spanning Three Networks. 


Note 1: Only the SSCP-SSCP session communication is shown. Assume LU1 (a logical unit owned by 
SSCP1 in Network A) requests a session with DLUX (an alias for LU3 in Network B; LU3 is a logical unit 
owned by gateway SSCP3). LU1 is the SLU in the request session. 


Note 2: Session setup proceeds as shown in the basic flows. BIND flows from LU3 to gateway NCP2, to 
gateway NCP1, and to LU1. 
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Figure 154 (Part 1 of 2). mvs vm Establishing a Cross-Network LU-LU Session: SLU-Initiated Request for Predesig- 
nated Control of GWNCP by Middle Host (Pre-V3R2) 
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Figure 154 (Part 2 of 2). MvS VMEstablishing a Cross-Network LU-LU Session: SLU-Initiated Request for Predesig- 
nated Control of GWNCP by Middle Host (Pre-V3R2) 
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Figure 155 (Part 1 of 2). mvs vm Establishing a Cross-Network LU-LU Session: SLU-Initiated Request for Predesig- 


nated Control of GWNCP by Middle Host (V3R2) 
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Figure 155 (Part 2 of 2). mvs vMEstablishing a Cross-Network LU-LU Session: SLU-Initiated Request for Predesig- 
nated Control of GWNCP by Middle Host (V3R2) 
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Figure 156. MVS VM Establishing a Cross-Network LU-LU Session: Multiple GWSSCPs and Back-to-Back GWNCPs 
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Figure 157. MVS VMEstablishing a Cross-Network LU-LU Session: Third Party-Initiated Request Spanning Three Net- 


works 
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Figure 158. MVS VMEstablishing a Cross-Network LU-LU Session: Initiate with VARY LOGON or Controlling PLU for 


Single GWSSCP/Single GWNCP (Pre-V3R2). 


Note 1: Assume LU1 is active. 


Note 2: Session setup continues as shown in the basic flows. 
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Figure 159. MVS vM Establishing a Cross-Network LU-LU Session: Initiate with VARY LOGON or Controlling PLU for 


Single GWSSCP/Single GWNCP (Pre-V3R2). 
Note 1: Assume LU1 is active. 


Note 2: Session setup proceeds as shown in the basic flows. 
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Figure 160. MVS VM Establishing a Cross-Network LU-LU Session: SLU-Initiated Session Initiation Failure (CDINIT 


Rejection) for Single GWNCP (Pre-V3R2) 
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Figure 161.MVS VM Establishing a Cross-Network LU-LU Session: SLU-Initiated Session Initiation Failure (CDINIT 
Rejection) for Single GWNCP (V3R2) 
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Figure 162. MVS VM Establishing a Cross-Network LU-LU Session: SLU-Initiated Session Initiation Failure (SETCV) 


for Single GWSSCP/Single GWNCP (Pre-V3R2) 
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Figure 163. MVS VM Establishing a Cross-Network LU-LU Session: SLU-Initiated Session Initiation Failure (SETCV) 
for Single GWSSCP/Single GWNCP (V3R2) 
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Figure 164. MVS VM Establishing a Cross-Network LU-LU Session: SLU-Iinitiated Setup Procedure Failure (CINIT 
Rejection) for Single GWSSCP/GWNCP (Pre-V3R2) 
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(reject at PLU) 


Figure 165.MVS VM Establishing a Cross-Network LU-LU Session: SLU-Initiated Setup Procedure Failure (CINIT 
Rejection) for Single GWSSCP/GWNCP (V3R2) 
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Gateway NCP 


LU1 Gateway for Network A Gateway LU2 
(SLU) SSCP SSCP1 and Network B SSCP2 (PLU) 
UNBIND 
UNBIND 
“RESP (UNBINO} ar 
+RESP (UNBIND) 
NOTIFY 
(SESSION END) 
NOTIFY 
(SESSION END) 
tRESP 
(NOTIFY) 
+RESP 
(NOTIFY) 
CDSESSEND 
(a) 
CDSESSEND 
(b) 
CDSESSEND 
b 
SESSEND 
SESSEND 

+RESP 
COSESSEND(b 


COSESSEND(b 


Figure 166.mvs vm Deactivating Resources and Ending Sessions: PLU sends UNBIND for Single GWSSCP and 


Single GWNCP 
LU1 BF BF LU1 
(PLU) (PLU) SSCP1 SSCP2 (SLU) (SLU) 
UNBIND 
Ts wane 
CDSESSEND 
+ RSP(CDSESSEND) 
' aie + eee | 


Figure 167.mvs vm Deactivating Resources and Ending Sessions: Independent PLU sends UNBIND for Cross- 
domain LU-LU session 
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LU1 BF BF LU1 
(PLU) (PLU) SSCP1 SSCP2 (SLU) (SLU) 


BFCLEANUP 


CDSESSEND 
(cleanup) aan 
t RSP(BFCLEANUP) BFSESSEND 


FNA 


ie FNA 
RSP(FNA) 


Figure 168. MVS VM Deactivating Resources and Ending Sessions: Independent PLU sends BFCLEANUP for Cross- 
domain LU-LU session. 
’ BFCLEANUP may be sent by the SSCP(PLU) for several reasons, including: 


A network operator at the SSCP(PLU) may issue a VARY NET,TERM,UNCOND, generating an 
internal TERM-OTHER (forced). 


A network operator at either SSCP may issue a VARY NET,INACT,ID=cdrm, deactivating all cross- 
domain sessions between the SSCPs. 
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Gateway NCP 
LU1 Gateway for Network A LU2 
(SLU) SSCP1 SSCP1 and Network B SSCP2 (PLU) 


TERM_SELF 


COTERM 
+RESP 


COTERM 


CDTERM 


CTERM 
+RESP (CDTERM) 
+RESP (CDTERM) 
+RESP (CTERM) 
+ RESP (CDTERM) 
UNBIND 


UNBIND 


NOTIFY 
(SESSION END) 


+RESP (NOTIFY) 


CDSESSEND (a) 
COSESSEND (b) 


+ RESP 
(CDSESSEND (a)) 


+RESP (UNBIND) 


CDOSESSEND (b) 
ee 


SESSEND 


SESSEND +RESP 


(CDSESSEND (b)) 


+RESP 
(COSESSEND (b}) 


Figure 169. MVS VM Deactivating Resources and Ending Sessions: SLU Requests Terminate Self for Single GWSSCP 
and Single GWNCP 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 Appendix C. Network Flows 635 


Gateway NCP 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


LU1 Gateway for Network A LU2 
(SLU) SSCP1 SSCP1 and Network B SSCP2 (PLU) 
TERM_SELF, 
(CLEANUP) 
+RESP 
CDTERM 
(CLEANUP) 
DACTLU 
+RESP 
+RESP 
(CDTERM) 
CDTERM 
(CLEANUP) 
CDTERM 
(CLEANUP) 
CLEANUP 
+ RESP + RESP 
(NOTIFY) (CLEANUP) 
tRESP 
__(CDTERM) 


1RESP 
(CDTERM) 


Figure 170. MVS VMDeactivating Resources and Ending Sessions: SLU Requests Terminate Self (Cleanup Option) 
for Single GWSSCP/GWNCP (Pre-V3R2) 
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Gateway NCP 


LU1 Gateway for Network A LU2 
(SLU) SSCP1 SSCP1 and Network B SSCP2 (PLU) 
TERM_SELF, 
(CLEANUP) CDTERM 
(CLEANUP) 
+*RESP 
DACTLU 
t+ RESP NOTIFY 


ACTLU 
+ RESP 


CDTERM 
(CLEANUP) 


CDTERM 
(CLEANUP) 


CLEANUP 


+RESP +RESP 
(NOTIFY) (CLEANUP) 


Figure 171. MVS vMDeactivating Resources and Ending Sessions: SLU Requests Terminate Self (Cleanup Option) 
for Single GWSSCP/GWNCP (V3R2) 
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Gateway NCP 


LU1 Gateway for Network A LU2 
(SLU) SSCP1 SSCP1 and Network B SSCP2 (PLU) 
UNBIND 
UNBIND 

+RESP (UNBIND) 

NOTIFY 

(SESSION END) 

+ RESP 
(NOTIFY) 
CDSESSEND 
(a) 
CDSESSEND 
& 
CDSESSEND 
(b) 
SESSEND 
+RESP 
(CDSESSEND) (b)) 
+RESP 
(CDSESSEND) (a)) 
+RESP 
SESSEND (CDSESSEND) (b)) 


Figure 172. mvs vm Deactivating Resources and Ending Sessions: PLU Sends UNBIND for Multiple GWSSCPs and 
Single GWNCP 
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Gateway NCP1 


Gateway NCP2 


LU1 Gateway for Network A for Network C Gateway LU2 
(SLU) SSCP1 SSCP1 and Network C and Network B SSCP2 (PLU) 
TERM_SELF 
CDTERM 
+RESP CDTERM 
CDTERM 
___CDTERM 
CRESP CTERM 
~RESP CUCM) +RESP 
(CDTERM) (CTERM) 
+RESP 
(CDTERM) 
+RESP 
(CDTERM) GAIN 
UNBIND 
UNBIND 
+RESP 
(UNBIND) + RESP 
(UNBIND) 
NOTIFY 
(SESSION END) 
+RESP RESP 
NOTIFY (UNBIND) 
CDOSESSEND (a) 
Eppes) CDSESSEND (a) | NOTIFY 
(SESSION END) 
COSESSEND (a) 
+RESP 
NOTIFY 
saree SU, SESSEND 
(CDSESSEND (b) (RESP 
( +RESP (CDSESSEND) 
(CDSESSEND (a) a 
+RESP 
SESSEND (COSESSEND (a) 


Figure 173. mvs vm Deactivating Resources and Ending Sessions: SLU Requests Terminate Self for Multiple 


GWSSCPs and Back-to-Back GWNCPs 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


Appendix C. Network Flows 


639 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


PU Type 4/ 
Gateway PU Type 5 Gateway 
NCP1 for Intermediate NCP2 for 
Lu1 Gateway Network A Routine Node Network C Gateway LU2 
(SLU) SSCP1 SSCP1 and Network C = (Network C) and Network B SSCP2 (PLU) 
ER_INOP 
See Note 
ERANOP 
UNBIND (VR_INOP) 
UNBIND (VR_INOP) 
+RESP (UNBIND) 
NOTIFY 
(SESSION END) 
<4 
CDOSESSEND 
— 
CDSESSEND 
+RESP 
SESSEND 
(CDOSESSEND) + RESP 


+ RESP (UNBIND) 


NOTIFY 


(SESSION END) 


+RESP 


SESSEND 


Note: An outage occurs un the route in Network C used by the LU1—LU2 session. ER_INOP reports the 
failure to gateway NCP? and gateway NCP2. 


Figure 174. MVS VM Deactivating Resources and Ending Sessions: Terminating an SSCP-SSCP Session 
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Gateway NCP1 


Gateway NCP2 


LU1 Gateway for Network A for Network C Gateway LU2 
(SLU) SSCP1 SSCP1 and. Network C and Network B SSCP2 (PLU) 
TERM_SELF 
CDTERM 
CDTERM 
CDTERM 
CDTERM 
CTE 
+ RESP aM 
aie (CDTERM) napee 
(CDTERM) (CTERM) 
+RESP 
(COTERM) 
+RESP 
(CDTERM) tue 
UNBIND 
UNBIND 
+ RESP 
(UNBIND) | RESP 
SIN - (UNBIND) 
NOTIEY 
SESSEND (SESSION END) 
| RESP RESP 
NOTIFY (UNBIND) 
CDSESSEND (a) 
CDSESSEND (b) CDSESSEND (a) | NOTIFY 


+RESP 
(CDSESSEND (b) 


+ RESP 
(CDSESSEND (a) 


+RESP 
(CDSESSEND (a) 


(SESSION END) 


CDSESSEND (a) 


+RESP 
(NOTIFY) 


+RESP 
(CDSESSEND) 
a 


SESSEND 


Figure 175. MVS VM Deactivating Resources and Ending Sessions: Active Session Termination of T2.1 Nodes 
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Gateway NCP 


LU3 Gateway for Network A Gateway LU2 
(PLU) SSCP1 SSCP1 and Network B SSCP2 (SLU) 
See Note 1 
CDTAKED 
CDTAKED 
CDTERM (address of + RESP 
LU3,address of LU2 t RESP 
alias) 
<q ___________ 
*+RESP 
CTERM 
+RESP 
UNBINO 
UNBIND 
+RESP (UNBIND) 


NOTIFY 
(SESSION END) 


NOTIFY 
(SESSION END) 


CDSESSEND (a) ' 


+RESP 


— - 
+RESP CDTAKEDC 


vse | 
coraceoc | 


CDSESSEND (b) * 


CDSESSEND (a)! 


+RESP 


SESSEND DACTCDRM 
+RESP 


NOTIFY ° 
(free transform) 
+RESP 


Figure 176. MVS VM Deactivating Resources and Ending Sessions: Route Failure Causes Session Termination 
(Pre-V3R2). Note 1: A cross-network LU-LU session exists between LU3 and LU2. 


' See Figure 166 on page 633 through Figure 178 on page 644 for details of CODSESSEND processing. 
> This flow assumes that the gateway SSCP1 established the network address translation for the 


gateway SSCP1-to-gateway SSCP2 session with the RNAA RU. The NOTIFY to free the transform is sent 
only if the RNAA that established the address specified “retain address.” 
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Gateway NCP 


LU3 Gateway for Network A Gateway LU2 
(PLU) SSCP1 SSCP1 and Network B SSCP2 (SLU) 
See Note 1 
CDTAKED 
CDTAKED 


COTERM (address of +RESP 


LU3,address of LU2 t RESP 
alias) 
CTERM + 
+RESP 
+RESP 
UNBIND 


UNBIND 


+RESP (UNBIND) 


+RESP (UNBIND) 


NOTIFY 
(SESSION END) 


SESSEND 


NOTIFY 
(SESSION END) 


1 
CDSESSEND (b) CDSESSEND (a)' 


CDSESSEND (a) ' 
+RESP +RESP 
CDTAKEDC 
+RESP 
comakeoe, =f 


DACTCDRM 


+RESP 


NOTIFY? 
(free transform) 


+ RESP 


Figure 177. MVS VM Deactivating Resources and Ending Sessions: Route Failure Causes Session Termination 
(V3R2). Note 1: A cross-network LU-LU session exists between LU3 and LU2. 


1 See Figure 166 on page 633 through Figure 178 on page 644 for details of CDSESSEND processing. 
* This flow assumes that the gateway SSCP1 established the network address translation for the 


gateway SSCP 1-to-gateway SSCP2 session with the RNAA RU. The NOTIFY to free the transform is sent 
only if the RNAA that established the address specified “retain address." 
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PU Type 4/ 
PU Type 5 
Gateway NCP1 Intermediate Gateway NCP2 
Gateway for Network A Routing Node for Network C Gateway 
SSCP1 SSCP1 and Network C (Network C) and Network B SSCP2 


See Note 1 


ER_INOP 


ER-INOP 


DACTCDRM 


(VR_INOP) 
DACTCDRM 


(VR INOP) 


+RESP 
(DACTCDRM) 
+RESP 
(DACTCDRM) 


NOTIFY ' 
(free transform) 


NOTIFY * 
(free transform) 


Figure 178. MVS VM Deactivating Resources and Ending Sessions: Route Failure Causes Session Termination for 
Multiple GWSSCPs and Back-to-Back GWNCPs. 


Note 1: An outage occurs on route in Network C used by the gateway SSCP 1-to-gateway SSCP2 session. 
The failure is reported to gateway NCP1 and gateway NCP2 with an ER INOP RU. 


1 The NOTIFY to free the transform is sent only if the RNAA that established the address specified 
“retain address.” 
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Appendix D. CPCB Operation Codes 


Many VTAM processes are represented by RUPE, NCSPL, DLRPL, CPCB, PPL, or TQE work 
elements. Each of these work elements contains a prefix called a cPcsB at the 
beginning of the control block. The cPcs prefix contains a field called the cPcB 
operation code (CPCBOPC), which provides an exact indication of the type of VTAM 
process represented by the work element. 


The cpcsorc field is located at a displacement of hex 10 (decimal 16) from the 
beginning of each of the above-named control blocks. The cpcsopc field is 4 bytes 
long and contains a category byte (CPCBCAT), followed by a 3-byte specific opera- 
tion code field (CPCBFMH#). 


The possible contents of the CPCB operation code category are summarized below: 


Category (hex) Meaning 


00 Operator command 

01 Dump/load/restart request 

02 I/O purge request 

03 Timer management request 

04 Unformatted RU 

08 Function management data RU 

09 Network control RU 

OA Data flow control RU 

OB Session control RU 

OC Function management data access method RU 
OD Network control access method RU 
OE Data flow control access method RU 
OF Session control access method RU 


The following table summarizes the possible values of the CPpcB operation code 
field. For each value, the character string representation which may appear in 
VTAM operator messages is given, along with the function of the associated work 
element. 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 Appendix D. CPCB Operation Codes 645 


646 VTAM Diagnosis 


CPCBOPC 


00010000 
00010001 
00010002 
00010004 
00010005 


00010008 
00010012 
00010032 
00010040 
00010041 


00010045 


00010100 
00010200 
00010400 
00010802 
00011002 
00011802 
00012000 
00012001 


00012002 
00012005 


00014000 
00014010 
00018004 
00020001 
00020002 
00020004 


Message 


VARY 

VARY ACT 
VARY INACT 
VARY LOGON 
VARY ACT 


VARY DRDS 
VARY INACT 
VARY INACT 
VARY ANS 
VARY ACT 


VARY ACT 


VARY PATH 
VARY PATH 
VARY INOP 
FORCE DEAC 
FORCE REAC 
VARY INACT 
VARY ACQ 
VARY ACQ 


INACT SON 
VARY ACQ 


VARY REL 
VARY REL 
VARY NOLOGON 
F DUMP 

F ENCR 

F CHANGE 
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Function 


VARY Command 
VARY Activate 
VARY Deactivate 
VARY LOGON 


VARY Activate, 
LOGON Parameter Specified 


VARY DRDS 

VARY. Deactivate Immediate 

VARY Deactivate immediate (internal) 
VARY ANS 


VARY Activate, 
ANS Parameter Specified 


VARY Activate, 
ANS and LOGON Parameters Specified 


VARY PATH=USE 

VARY PATH = NOUSE 
VARY INOP 

Force Deactivate 

Force Reactivate 

VARY Deactivate Giveback 
VARY Acquire 


VARY Activate, 
ACQ Parameter Specified 


Deactivate (Session Outage Notification) 


VARY Activate, 
ACQ and LOGON Parameters Specified 


VARY Release 

VARY Release Immediate 
VARY NOLOGON 
MODIFY DUMP 

MODIFY ENCR 

MODIFY CHANGE 
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CPCBOPC 


000200A0 
000200C0 
00020010 
00020120 
00020140 
00020180 
00020200 
00020280 
00020401 


00020408 
00020480 
00020301 
00020808 
00020820 
00020840 
00020880 
00021001 
00021801 
00022001 
00022801 
00024001 
00024020 
00024040 
00028001 
00028820 
00028840 
00030001 
00030002 
00030004 
00040000 


Message 


F TRACE 

F NOTRACE 

F TABLE 

F AGPTRACE 
F DGPTRACE 
F LOAD ADD 
F CDRM 

F LOAD REP 


TRANSFER NCP 
DUMP 


F DR MOVE 

F LOAD PRG 
PRG NCP DUMP 
F DR DELETE 

F ALTRACE 

F DLTRACE 

F LOAD CNC 

F DUMP CSP 
PRG DUMP CSP 
F DUMP MOS 
PRG DUMP MOS 
F DUMP DYN 

F ACT SIT 

F DACT SIT 

F DUMP DYN CH 
F ATGTRACE 

F DTGTRACE 
SOFT INOP 
SSCP TKOVR 
HARD INOP 
DISP INT 
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Function 


MODIFY TRACE, NETCNTR 

MODIFY NOTRACE, NETCNTR 

MODIFY TABLE 

MODIFY Activate generalized PIU trace 
MODIFY Deactivate generalized PIU trace 
MODIFY LOAD ADD 

MODIFY CDRM 

MODIFY LOAD REPLACE 

Transfer DUMP (NCP) 


MODIFY DR MOVE 

MODIFY LOAD PURGE 
PURGE DUMP (NCP) 
MODIFY DR DELETE 
MODIFY Activate Line Trace 


.MODIFY Deactivate Line Trace 


MODIFY LOAD CANCEL 
MODIFY DUMP (CSP) 
PURGE DUMP (CSP) 
MODIFY DUMP (MOSS) 
PURGE DUMP (MOSS) 
MODIFY Dump (Dynamic) 
MODIFY Activate SIT Trace 
MODIFY Deactivate SIT Trace 
MODIFY Dump (Dynamic-CH) 
MODIFY Activate TG Trace 
MODIFY Deactivate TG Trace 
SOFT INOP 

SSCP TAKEOVER 

HARD INOP 


Display Internal Commands 


/ 
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CPCBOPC 


00060001 
00060002 
00060004 
00060008 
00060010 
00060020 
00060040 
00060100 
00061001 
00062000 
00062001 
00063001 
00063002 
00064000 
00064001 
00068000 
00080001 
012B0000 
01460000 
01BD0000 
01DD0000 
01EA0000 
01ED0000 
02510000 
02520000 
03000000 
04000000 
08010001 
08010002 
08010003 
08010004 


Message 


INT SYNCH 
IPL INIT 

IPL TEXT 

IPL FINAL 
DUMP INIT 
DUMP TEXT 
DUMP FINAL 
HALT CDLNK 
REQODMP CSP 
RESET LU 
REQDMP MOS 
INT TRF DH 
INT TRF DMS 
REQLOAD 
REQDUMP DY 
REQDUMP 
DIAL START 
CKPTN 
CHKPT 
CPMSG 

DLR PURGE 
CPCRYPT 
SELECT VR 
CDRM CLEAR 
CDRM ERP 
TIMER REQ 
CHAR CODED 
CHG TLIMIT 
CHG NRSPOL 
CHG SESSLM 


CHG POLLIM 
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Function 


Internal Synchronization Function 


‘IPL Initial Request 


IPL Text Request 

IPL Final Request 

Dump Initial Request 

Dump Text Request 

Dump Final Request 

Process Cross-Domain Links During HALT 
Request CSP Dump 

Reset LU 

Request MOSS Dump 

internal transfer of dump header 
Internal transfer of dump main storage 
Request Load 

Request Dynamic Dump Data 

Request Dump 

Dial Start Request 

Checkpoint Node Status Function 
Checkpoint Resource Status Function 
Internal WTOR Function 
Dump/Load/Restart Purge 
Cryptography Management Function 
Virtual Route Select 

Clear CORM-CDRM Session 

CDRM ERP Internal Clear 

Set Timer Request 

Unformatted Request Unit 

Change Transmission Limit 

Change Negative Response to Poll Limit 
Change Session Limit 


Change Poll Limit 
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CPCBOPC 


08010201 

08010202 
08010203 
08010204 
08010205 
08010206 
08010207 
08010208 
08010209 
0801020A 
0801020B 
0801020E 
0801020F 
08010211 

08010214 
08010215 
08010216 
08010217 
08010218 
08010219 
0801021A 
0801021B 
08010280 
08010281 

08010284 
08010285 
08010302 

08010303 
08010331 

08010334 
08010381 


Message 


CONTACT 
DISCONTACT 
IPL INIT 

IPL TEXT 

IPL FINAL 
DUMP INIT 
DUMP TEXT 
DUMP FINAL 
RMPO 
ACTLINK 
DACTLINK 
CONNOUT 
ABCONN 
SCV 

ENT SLOWDN 
EXT SLOWDN 
ACTCONNIN 
DACTCONNIN 
ABCONNOUT 
ANA 

FNA 
REQDISCONT 
CONTACTED 
INOP 
REQCONT 
NSLSA 
ACTTRACE 
DACTTRACE 
DISP STOR 
RECSTOR 
RECMS 
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Function 


Contact 

Discontact 

NC IPL Initial 

NC IPL Text 

NC IPL Final 

Dump Initial 

Dump Text 

Dump Final 

Remote Power Off 
Activate Link 
Deactivate Link 
Connect Out 

Abandon Connection 
Set Control Vector 
Enter Slowdown 

Exit Slowdown 
Activate Connect In 
Deactivate Connect In 
Abandon Connect Out 
Assign Network Address 
Free Network Address 
Request Discontact 
Contacted 

inoperative 

Request Contact 
Network Services Lost Subarea 
Activate Trace 
Deactivate Trace 
Dispiay Storage 
Record Storage 


Record Maintenance Statistics 
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CPCBOPC 


08010382 
08010383 
08010480 
08010604 
08010681 
08010683 
083F0233 
083F0234 
083F0814 
083F0816 
08410210 
08410220 
08410237 
08410240 
08410243 
08410244 
08410245 
08410246 
08410286 
08410287 
08410289 
0841028A 
08410304 
08410305 
08410307 
08410311 
08410384 
08410385 
08410386 
08810387 
08810389 


Message 


REC TEST 
REC TRACE 
RECMD 
NSPE 

INIT SELF - 
TERM SELF 
INIT LOAD 
LOAD STAT 
TR-INQUIRY 
TR-REPLY 
RNAA 

NFY SESSEND 
LOAD REQRD 
ADDNR 

IPL INIT 

IPL TEXT 

IPL FINAL 

IPL ABORT 
RDELETENR 
LOST CTLPT 
ROUTE-INOP 
REQACTCDRM 
REQ MNT ST 
LINKLVL2 
REQ RTTEST 
MS SCV 
RECFMS 
RECTR 

ER TESTED 
REQ ECHO 
ECHO TEST 
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Function 


Record Test Data 

Record Line Trace Data 

Record Measurement Data 

Network Services Procedure Error 
Initiate(Self) Format 0 
Terminate(Self) Format 0 

NS Init Load 

NS Load Status 

Translate Inquiry 

Translate Reply 

Request Network Address Assignment 
Notify Sessend 

NS Load Required 

Add Network Resource 

NS IPL Init 

NS IPL Text 

NS IPL Final 

NS IPL Abort 

Request Delete Network Resource 
Lost Control Point 

Network Services Route Inoperative 
Request ACTCDRM 

Request Maintenance Statistics 
Enter Test Mode (LL2) 

Request Route Test 

Maintenance Services Set Control Vector 
Record Formatted Maintenance Statistics 
Record Test Results 

Explicit Route Tested 

Request Echo Test 

Echo Test 
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CPCBOPC 


08810601 

08810602 
08810620 
08810629 
08810680 
08810681 

08810682 
08810683 
08810685 
08810686 
08810687 
08810688 
08810810 
08810812 
08810814 
08812601 

08812629 
08812681 

08812683 
08812686 
08812688 
0881268C 
08818620 
08818627 
08818640 
08818641 

08818643 
08818645 
08818646 
08818647 

08818648 


Message 


CINIT 

CTERM 
NOTIFY 
CLEANUP 
INIT OTHER 
INIT SELF 
TERM OTHER 
TERM SELF 
BIND FAIL 
SESS START 
UBIND FAIL 
SESS ENDED 
FORWARD 
DELIVER 
CNM REQ 

BF CNTL INIT 
BF CLEANUP 
BF INIT 

BF TERM 

BF SESS STRT 
BF SESS END 
BF SESS INFO 
CD NOTIFY 
CD DSEARCH 
CDINIT OTH 
CDINIT 
CDTERM 
CDSSF 
CDSESSST 
CDSTF 
CDSESSEND 
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Function 


Control Initiate 

Control Terminate 

Notify 

Cleanup 

Initiate(Other) 

Initiate(Self) Format 1 
Terminate(Other) 
Terminate(Self) 

Bind Failure 

Session Started 

Unbind Failure 

Session Ended 

Forward Request 

Deliver Request 

CNM Request 

BF Control Initiate 

BF Cleanup 

BF Initiate 

BF Terminate 

BF Session Start 

BF Session End 

BF Session Information Request 
Cross-Domain Notify 
Cross-Domain Direct Search List 
Cross-Domain Initiate (Other) 
Cross-Domain Initiate 


Cross-Domain Terminate 


Cross-Domain Session Setup Failure 


Cross-Domain Session Started 


Cross-Domain Session Takedown Failure 


Cross-Domain Session Ended 
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CPCBOPC 


08818649 
0881864A 
0881864B 
09050000 
09060000 
09070000 
09080000 
09090000 
OS0A0000 
0S0B0000 
0s0C0000 
090D0000 
OSOEC000 
0S0FO000 
09510000 
09520000 
0A040000 


OA050000 . 


0A700000 
0A7 10000 
0A800000 
0A810000 
0A820000 
0A830000 
0A840000 
OACO00000 
0AC 10000 
0AC20000 
0AC80000 
OACS0000 
OBOD0000 


Message 


CDTAKEDOWN 
CDTD COMP 
CDCINIT 
NCLSA 

ER INOP 
ANSC 

LOST PATH 
ER TEST 

ER TST RPY 
ER ACT 

ER ACT RPY 
ACTVR 
DACTVR 

ER OP 

SW TO NCP 
SW TO EP 
LUSTAT 
RTR 

BIS 

SBI 

QEC 

QC 

RELQ 
CANCEL 
CHASE 
SHUTDOWN 
SHUTC 
RSHUTD 
BID 

SIGNAL 
ACTLU 
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Function 


Cross-Domain Takedown 
Cross-Domain Takedown Complete 
Cross-Domain Control Initiate 
Network Control Lost Subarea 
Explicit Route Inoperative 
Auto Network Shutdown Complete 
Lost Path 

Explicit Route Test 

Explicit Route Test Reply 
Explicit Route Activate 
Explicit Route Activate Reply 
Activate Virtual Route 
Deactivate Virtual Route 
Explicit Route Operative 
Switch Line to NCP Mode 
Switch Line to EP Mode 

LU Status 

Ready to Receive 

Bracket Initiation Stopped 
Stop Bracket Initiation 
Quiesce at End of Chain 
Quiesce Complete 

Release Quiesce 

Cancel 

Chase 

Shutdown 

Shutdown Complete 

Request Shutdown 

Bid 

Signal 

Activate LU 
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CPCBOPC 


OBOEO000 
0B 110000 
08120000 
08140000 
08150000 
0B310000 
0B320000 
OBAOO0000 
OBA10000 
OBA20000 
OBA30000 
OBCO0000 
0C0102A0 
0C0102A1 
0C0102A2 
0C0102A3 
0C010480 


00410206 
00410207 
00410208 
00410210 
00410212 
00410213 
00410214 
00410266 
0C4102BD 
0C4102BE 
004102BF 
004102CD 
004102CE 


Message 


DACTLU 
ACTPU 
DACTPU 
ACTCDRM 
DACTCDRM 
BIND 
UNBIND 

SDT 

CLEAR 

STSN 

RQR 

CRV 

AM ALLORSC 
AM FREERSC 
AM SETRT 
AM RESETRT 


AM RCRD MS 
DATA 


AM GAINED GWN 
AM LOST GWN 
AM DACT TRF 
AM RNAA 

AM CONN 

AM DISC 

AM INIT PU 
XID 

AM ADDLINK 
AM ADDLSTA 
DELETENR 
AM REQDUMP 
AM CONDLOD 
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Function 


Deactivate LU 
Activate PU 
Deactivate PU 
Activate CDRM 
Deactivate CDRM 
Bind Session 

Unbind Session 

Start Data Traffic 
Clear Session 

Set and Test Sequence Numbers 
Request Recovery 
Cryptography Verify 
Allocate Resource 
Free Resource 

Set Routable State 
Reset Routable State 


Record Measurement Data 


Gained GWN 

Lost GWN 

Deactivate Transforms 
Request Network Address Assignment 
Connect 

Disconnect 

Initiate PU 

AM Exchange !ID 

Add Link 

Add Link Station 

Delete Network Resource 
Request Dump 


Request Conditional Load 
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CPCBOPC 


004102CF 
00410601 

00410602 

0C810619 

00810620 

00810629 

00810643 

0C810680 

00810681 

0C810801 

0C810A00 
0C810A01 
0C810A02 
0C810A10 
0C810A20 
0C810A21 
0C810A30 
0C810A31 
0C810A32 
0C810A33 
0C810A34 
0C810A35 
0C810A36 
0C810A37 
0C810A38 
0C810A39 
0C810A40 
0C810A50 
0C810A51 
0C810A60 
0C810A70 


Message 


AM UNCDLOD 


AM OPNACB 
AM CLSACB 
AM ARCA 
AM RESUME 
AM CLEANUP 


Generic TERM 


AM REALLOC 


GEN SESS INIT 


AM NOTIFY 
API SETLST 
API SETLSP 
API SETLQS 
API SIMLOG 
AP! OPNACQ 
API OPNACC 
API INQLOG 
API INQDVC 
API INQCNT 
API INQTOP 
API INQCID 
API INQTRM 
API INQAPS 
API INQSPM 
API INQSKY 
AP! INQDSP 
AP! INTERP 
API CLSPAS 
AP! CLSRLS 
API SESONC 
API SNDCMD 
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Function 


Request Unconditional Load 
Open ACB 

Close ACB 

Address Request Complete 
Resume 

Cleanup 

Termination Placeholder 
Reallocate 

Generic Session Initiation 
Notify 
SETLOGON(START) 
SETLOGON(STOP) 
SETLOGON(QUIESCE) 
SIMLOGON 
OPNDST(ACQUIRE) 
OPNDST(ACCEPT) 
INQUIRE(LOGONMSG) 
INQUIRE(DEVCHAR) 
INQUIRE(COUNTS) 
INQUIRE(TOPLOGON) 
INQUIRE(CIDXLATE) 
INQUIRE(TERMS) 
INQUIRE(APPSTAT) 
INQUIRE(SESSPARMS) 
INQUIRE(SESSKEY) 
INQUIRE(DISPLAY) 
INTRPRET 
CLSDST(PASS) | 
CLSDST(RELEASE) 
SESSIONC 

SENDCMD 
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CPCBOPC 


0C810A75 
0C810A80 
0C810A85 
0C810AS0 
0C810AA0 
0C810AB0 
0C810ACO0 
0D010000 
0DOBO0000 
ODOEOC0O 
ODFFOO000 
0E010000 
0FO010000 
0FO020000 
0F030000 
0F040000 
OFO50000 
OFO60000 
| 0F310000 
0F320000 
FFOOO000 


Message 


API SEND 
API RCVCMD 
API RECEIVE 
API REQSES 
API OPNSEC 
API TRMSES 
API RESETSR 
AM VR INOP 
AM REQ ERA 
AM REQ VRD 
AM VR STAT 
AM PCE 

AM NFY SLT 
AM SSA 

AM SSADISC 
AM OSA 

AM PWQ 

AM FLUSH 
AM GBIND 
AM GUNBIND 
VECTOR 
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Function 


SEND 

RCVCMD 

RECEIVE 

REQSESS 

OPNSEC 

TERMSESS 

RESETSR 

Virtual Route Jnoperative 
Request Explicit Route Activate 
Request Virtual Route Deactivate 
Virtual Route Status 

Purge Chain Element 

Notify (Schedule LOSTERM Exit) 
Set Session Address 

Set Session Address and Disconnect 
Override Session Address 
Purge Wait Queve 

Flush Virtual Route 

Generic BIND 

Generic UNBIND 

VECTOR FMD request units 
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aS SS See oe Sete © 


oa Open st Oe RAS 


Appendix E. Storage and Conirol Block ID Codes 


This appendix lists the control block 1D codes for vTAM and vscs control blocks. It 
also includes storage ID codes for vscs. 


This appendix contains the following sections: 


e “VTAM Control Block ID Codes” on page 658 
e “vm VSCS Storage and Control Block Identifiers” on page 659. 
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VTAM Control Block ID Codes 


You can identify certain VTAM control block types in a storage dump by examining 
an identification code in the first byte of the control block (offset 0). The control 
block identification codes are shown in the following table. !n case of duplicate 
codes, use other means (such as the operating environment or the control block’s 
context) to determine the type of control block. 
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00 
00 
01 
03 
05 


48 
49 
4A 
4C 
4D 
4E 


Figure 179. Control Block iD Codes 


Contro! Block 


RPL 

SONCB 

RPH 

FMCB 

VRBLK 

ICNCB 

LDNCB 

HALCB 

BSCLB 

VLNCB (V3R1.2 and later) 
PCLCB (V3R1.2 and later) 
PRWCB (V3R1.2 and later) 
TRGCB (V3R1.2 and later) 
ACDEB 

UECB 

DYPAB 

TRAC 

ERTE 

TIE 

PDVT 

CHAIN 

TGCB 

OCW 

VCCB (V3R1.2 and later) 
PICB (V3R1.2 and later) 
LMPCB 

RAQ 

PAQ 

SAT 

LICB (V3R1.2 and later) 
PUSCB 

PLSCB 

POIA 

POCB 

POMCB 

PORCB 

POWE 

MALT 

ERCT 

TGE 

VRWSE 
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ID Control Block 
50 8 DLRPL 

52 LUCB 

54 RUPE 

54 TUNB 

57 PPL 

58 TQE 

5F CPCB 

60 NCSPL 

61 PST 

62 LU 6.2 (V3R2) 
62 NSICB, NSSCB 
63 SMP 

65 NACP 

68 RSQE 

69 DTPL 

6B DSSIB (V3R2) 
6C  IOSIB (V3R2) 
6D ASRIT 

6E GWIT 

75 WRE 

77 ADJSR 

81 EXLST 

S96 SIBX 

97 SIBIX (V3R2) 
98 SIB 

99  TSCB 

9A PSPL (V38R1.2 and later) 
9A TSPL 

AO ACB 

A2 RNCA 

A3  ALCA 

BF COS 

CO LOGMD 

CA GRPCB (V3R1.2 and later) 
DO NIB 

EB AUTOE 

FE XCNCB 

FF OCA 

FF PLL (V3R1.2 and later) 
$PIO PIO 
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vm VSCS Storage and Control Block Identifiers 


You can identify certain vScs control block types in a storage dump by examining 


Storage Identifiers 


an identification code in the first byte of the control block. 


ID Storage Type 


Ss Static storage 
SD Dynamic storage 
ZZ Dummy storage prefix 


Control Block Identifiers 
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ID Control Block 

CG DTICGB 

Cl DTICIA 

CL DTICLB 

CM DTICMD 

DTICXWB DTISWBs for Communication Services 
DTIPSWB DTISWBs for Presentation Services 
DTISPSB DTISWBs for Presentation Services Abends 
DTISUTB DTISWBs for Utility Services Abends 
DTISVSB DTISWBs for VTAM Services Abends 
DTITXWB DTISWBs for Timer Services 
DTIUSWB DTISWBs for Utility Services 
DTIVSWB DTISWBs for VTAM Services 
DTIVXWB DTISWBs for VTAM Exit Services 

IN DTIWEB internal 

PB DTIPDB 

PD DTIDSB for Presentation Services 
PG DTIPGB 

PL DTIPLB 

SA DTISAB 

SM DTISDB 

TA DTITAB 

TD DTIGTD 

TR DTITHDR 

UG DTIUGB 

VD DTIDSB for VTAM Services 

VE DTIVEIB 

VG DTIVGB 

VL DTIVLB 

4| DTIWEB IREAD internal read buffer 
1R DTIWEB IRECEIVE one-way reply 
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ID 


2R 
18 
28 
3R 
4R 
35 
4S 
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Control Block 


DTIWEB IRECEIVE one-way send 
DTIWEB ISEND one-way reply 
DTIWEB ISEND one-way send 
DTIWEB IRECEIVE two-way reply 
DTIWEB IRECEIVE two-way send 
DTIWEB ISEND two-way reply 
DTIWEB ISEND two-way send 
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VTAM path information unit (Piu) discard reason codes can be found in NetView 
trace panels and in the vTAM Internal Trace (viT) DSCD entry. When vTAM's trans- 
mission subsystem component (TSc) cannot forward a PiU towards its final destina- 
tion, it generates a discard trace entry, consisting of a discard reason code and the 
discarded Piu. The Tsc sends the discard trace entry to the NetView program, or to 
the vit, or to both. 


Note: NetView must be active to vTam in order to accept discard trace entries. The 
viT must also be active. 


To reference all discard entries sent to NetView, issue the following NetView 
command: 


SESS *DISCARD 


NetView puts discarded Plus in this file and, when possible, also puts them in the 
associated session trace file. 


Because Plus are often discarded without causing problems in the network, most 
discarded PiUs are not indicative of error conditions and do not need to be investi- 
gated. A discarded piu should be investigated only if an error symptom, such asa 
“hang” condition, occurs. 


For a description of NetView trace panels, see NetView Installation and Operation. 


See Chapter 8, “Using the VTAM Internal Trace” on page 307 for a full description 
of the VIT OSCD entry. 
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Discard Reason Codes 


Figure 180 lists the vrAm discard reason codes for each HS and Tsc module that 
discards Pius. HS and TSC modules, with their associated reason codes, are listed in 
alphanumeric order. For each reason code, a specific reason is given for the 
discard, followed by a probable cause. Probable causes are described in more 
detail in Figure 181 on page 670. | 


Reason 
VTAM Module Code Reason for Discard Probable Cause 
ISTHSCEP The session is being deactivated. Should not occur 
Unsent Pius must be discarded. 
The session is being deactivated. Pius Should not occur 
on the pacing queue must be discarded. 
The session is being deactivated. Pius 
on the HSPAB must be discarded. 
0004 The session is being deactivated. Expe- | Should not occur 
dited flow Pius must be discarded. 
ISTHSCGI 0001 Either insufficient resources, or LRM Should not occur 
encounters an error while processing. 


ISTTSCNS 0001 No processing is required for this FIDO Timing consideration 
PIU. with BSc 3270 


(No Session PAB 
Processor) 


ISTHSCRT 


ISTHSCRU 


A Plu was received from another vTAM 
component on the expedited work queue 
that is not a BIND Or UNBIND. 


that is not a BIND or UNBIND. 
ISTHSCRV Should not occur 
0004 Should not occur 
ISTHSCTP 0001 Should not occur 
is not supported. 
0001 Received piu caused Transmission Should not occur 
Control protocol violation. 


Figure 180 (Part 1 of 8). PIU Discard Reason Codes 
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Reason 
VTAM Module Code Reason for Discard Probable Cause 


Invalid BoU command code. 


ISTTSCBR 


No response to the command in 
progress, or the command in progress 
has been sent again. 


invalid contro! command. 


Not an error response, but SET MODE 
failed in processing completion of select 


0004 


BHSET command. 


CLEAR command in progress failed. 


Device reset. 


ISTTSCCN 
(V3R1.2 and later) 


ISTTSCCR 
(Connection Point 
Manager Receive) 


0001 The request TSCB iS a PRI.DT.SEND or a Timing on LU-LU session 


SEC.DT.RCV in pending reset state. traffic 


Inbound Fup request when SSCP-LU Timing on SSCP-LU 
session is not active. session traffic 


ISTTSCGR 0001 Should not occur 
(General Response 


Routine) 


Response could not be generated 
because the PIU was FIDO, was not first in 

the segment, was already a response, or 
a response was not allowed by RH. 


ISTTSCHT PIU is discarded from the PUT pending 
(V3R1.2 and later) traffic queue. 
Piu is discarded from the ncB pending 
traffic queue. 
PiU is discarded from the NCB work 
queue. 
0004 PIU is discarded from the nce inbound 
router PAB. 
ISTTSCIP 0001 The route is not available to the destina- | Post-failure traffic purge 
(Host IRN Processor) tion. 


}0002 A response cannot be generated. Post-failure traffic purge 


Figure 180 (Part 2 of 8). PIU Discard Reason Codes 
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Reason 
VTAM Module Code Reason for Discard Probable Cause 


ISTTSCIS 
(Inbound Session 
Control Function 

Interpreter) 


The response is discarded when 
PRILSESS.SEND is not in a pending active 
state. 


Timing on Lu-Lu session 
traffic. 


The response is discarded when 
PRI.DT.SEND is not in a pending active 
state. 


Timing on LU-LU session 
traffic. 


The response is discarded when 
PRI.OT.SEND is not in a pending reset 
state. 


0004 The response is discarded when Timing on LU-LU traffic 
RQA.SEND is not in a pending state. 


The response is discarded when Timing on LU-LU session 
PR!I.SESS.SEND or SEC.SESS.RCV is not in an traffic 
active state. 


0006 The session control response is invalid. Should not occur — 
logical unit error 

0007 Last in segment not received. Should not occur — 
logical unit error 


0001 The link is not contacted and active. Post-failure traffic purge 


Timing on LU-LU session 
traffic. 


ISTTSCIU 
(Host iRN Utility 
Processor) 


}0002 No IRN extension exists on the NCB. Post-failure traffic purge 


0001 Pius discarded from BCT pending traffic 
queue for logical unit session control 
request. 


ISTTSCJS 
(V3R1.2 and later) 


Pius discarded from BSCLB waiting 
printer end queue for logical unit 
session control request. 


Pius discarded from BCT pending traffic 
queue for PU session control request. 


0004 Pius discarded from BSCLB waiting 


printer end queue for PU session control 
request. 


Figure 180 (Part 3 of 8). PIU Discard Reason Codes 
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Reason 
VTAM Module Code Reason for Discard Probable Cause 
ISTTSCJT 0001 Piu is discarded from the BCT pending 
(V3R1.2 and later) traffic queue. 
0002 Piu is discarded from the BSCLB waiting 
printer end queue. 
0003 PIU is discarded from the PCPAB work 
queue. 
0004 Piu is discarded from the BSCLB inbound 
router PAB. 
ISTTSCLS 0001 The link is not yet active. Post-failure traffic purge 
(Local 3270 Write 
Scheduler) 


0002 The request was purged because of the Timing on Lu-LU session 
session control request that followed. traffic 


0001 This is not a migration route. Should not occur, or 
route has been rede- 


VM ISTTSCMB 


(Migration BIND, 
UNBIND, ACTCDRM, 
DACTCDRM 


Processor) 


fined. 


The ICNCB was not found. Post-failure traffic purge 


0002 
0003 


Should not occur —vR 
and TP numbers must be 
0 for migration 


The virtual route (VR) number and the 
transmission priority (TP) number are not 
0, as they must be for migration. 


Should not occur — error 
in network 


ISTTSCNC 
(Network Control 
Function Inter- 
preter) 


ISTTSCNS 


0001 The initialization complete request is the 
only inbound request allowed from 


network control. 


0001 


Timing consideration 
with BSC 3270 


No processing is required for this FIDO 
PIU. 


(No Session PAB 
Processor) 


ISTTSCPI 0001 The Ru size is exceeded, and the Plu is 
(Path Control not for session control. 
Inbound Processor) 


Logical unit problem — 
logical unit sent a PIU 

larger than the BIND-spec- 
ified maximum 


ISTTSCPR 
(Path Control 
Router) 


ISTTSCQD 
(Session Deacti- 


A response cannot be generated for an Post-failure traffic purge 


IRN PIU. 


Operation — operator 
deactivated CDRM from 
one host after activation 


A contention ACTCDRM was discarded 
because a DACTCDRM arrived from the 
same subarea. 


0001 


vation Request 
Processor) 


ISTTSCQF 0001 
(V3R1.2 and later) 


Abend recovery PiU discard 


Figure 180 (Part 4 of 8). PIU Discard Reason Codes 
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Reason 
VTAM Module Code Reason for Discard Probable Cause 


ISTTSCQP 0001 an ACTCDRM was discarded due to Operation — CDORM acti- 
(Session Deacti- ACTCDRM contention session restart. vated from both hosts 
vation Processor) simultaneously 


ISTTSCRA 
(Abend Recovery) 


This is not a “first-in-segment” Plu. Post-failure traffic purge 
after application program 
abend 


ISTTSCRI 
(Virtual Route Path 
Control Inbound) 


0001 


The origin subarea is invalid. Should not occur — adja- 
| cent NCP error 


The route is not usable. Post-failure traffic purge 
— ER not operative 


The sequence number is invalid. Should not occur — lost 
data or logical unit error 


ISTTSCRO 
(Virtual Route Path 
Control Outbound) 


The route is not active. Post-failure traffic purge 


The activation number does not match Post-failure traffic purge 
the vR activation number. 


The beginning of the Plu segment was Should not occur — 
lost. network error 


ISTTSCSA 
(Segment Assem- 
bler) 


Two “First-in-Segment” Pius were Should not occur — check 
received. Discard the partial piu logical unit 
segment and retransmit the piu. 


Hot 1/0. Discard all PiU segments for this Should not occur — check 
session. logical unit 


Figure 180 (Part 5 of 8). PIU Discard Reason Codes 
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Reason 
VTAM Module Code Reason for Discard Probable Cause 
ISTTSCSR 0001 Incorrect virtual route ID. Should not occur — Piu 
(Session Router) originator error 


A complete DACTCDRM request caused by | Network operator error 
contention resolution, session override, or transmission group 
or other session outage notification. failure 


Should not occur — out of 
synchronization. Pos- 
sibly misrouted. 


Session deactivation response and state 
is not pending reset. 


Should not occur — PiU 
originator error 


Negative session activation response 
and flow direction does not match the 
direction indicator. 


Should not occur — out of 
synchronization or lost 
traffic 


Negative session activation response 
and invalid sequence number. 


Out of synchronization — 
multiple session acti- 
vation and deactivation 
running concurrently 


0007 The session control response Piu is not Protocol violation by the 
flagged as expedited flow. response originator 


Figure 180 (Part 6 of 8). PIU Discard Reason Codes 


Negative session activation response 
and state is not pending active. 
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Reason 
VTAM Module Code Reason for Discard Probable Cause 


ISTTSCTS 0001 (SSCP,PU).BF.SESS.RCV is not pending Should not occur — out of 
(Boundary Function active for the ACTPU response. VTAM was synchronization on 


Transmission 


not waiting for an ACTPU response. SSCP-PU session 
Control Inbound) 


(SSCP,PU).BF.SESS.RCV is not pending reset Should not occur — out of 
for the DACTPU response. VTAM was not synchronization on 


waiting for a DACTPU response. SSCP-PU 

0003 (SSCP,SLU).BF.SESS.RCV is not pending Should not occur — out of 
active for the ACTLU response. VTAM was synchronization on 
not waiting for an ACTLU response. SSCP-LU session 

0004 (SSCP,LU).BF.SESS.RCV IS not pending reset Should not occur — out of 
for the DACTLU response. VTAM was not synchronization on 
waiting for a DACTLU response. SSCP-LU session 


reset during logical unit 
session activation 


0006 (PLU,SLU).BF.SESS.RCV is not pending Timing between sscp . 
active for the UNBIND response. VTAM was_| sessions and LU-LU 
not waiting for an UNBIND response. session — SSCP session 


(PLU,SLU).BF.SESS.RCV is not pending Timing between sscp 
active for the BIND response. VTAM was sessions and LUu-LU 
not waiting for a BIND response. session — SSCP session 


reset during logical unit 
session deactivation 


ISTTSCWS 0001 The channel link has not been contacted. { Post-failure traffic purge 
(Communication 

Controller/Cluster 

Controller Write 


Scheduler) 


ISTTSCXS The channel link is not in contacted or Post-failure traffic purge 
(Channel-to- active state. 

Channel Attach- 

ment Write 

Scheduler) 


ISTTSC3R 0001 DT.RCV is not active. Timing on Lu-LU session 
(3270 Virtual PU/LU traffic 

Transmission 

Control Outbound) 


= | The session is being reset. Timing on LU-LU session 
traffic 


Figure 180 (Part 7 of 8). PIU Discard Reason Codes 
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Reason 
VTAM Module Code Reason for Discard Probable Cause 


ISTTSC3S 


The session was not active, and the Piu 
received did not contain a session 
control RU. 


(3270 Virtual Pu/LU 
Transmission 
Control Inbound) 


(SSCP,PU).SEC.SESS.RCV is not pending 
active for the ACTPU response. VTAM was 
not waiting for an ACTPU response. 


(SSCP,PU).SEC.SESS.RCV Is not pending 
reset for the DACTPU response. VTAM was 
not waiting for a DACTPU response. 


0004 (SSCP,SLU).SEC.SESS.RCV is not pending 
active for the ACTLU response. VTAM was 


not waiting for an ACTLU response. 


(SSCP,SLU).SEC.SESS.RCV is not pending 
reset for the DACTLU response. VTAM was 
not waiting for a DACTLU response. 


0006 (PLU,SLU).SEC.SESS.RCV is not pending 
active for a BIND response. VTAM was not 


waiting for a BIND response. 


0007 (PLU,SLU).SEC.SESS.RCV is not pending 


reset for the UNBIND response. VTAM was 
not waiting for an UNBIND response. 


0008 


No discard codes from this module. 


ISTTSC6F 
Using TSALERT with reason code 0 for 
normal Piu discard. 


ISTTSC6Z 
(V3R1.2 and later) 


Retransmission of Piu, discard the 
partial piu. 


0004 


Figure 180 (Part 8 of 8). PIU Discard Reason Codes 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


End of Piu lost 


Appendix F. PIU Discard Reason Codes 


Timing on LU-LU session 
traffic 


Should not occur — out of 
synchronization on 
SSCP-PU session 


Should not occur — out of 
synchronization on 
SSCP-PU session 


Timing between sscp-PuU 
and SSCP-LU sessions 


Timing between sscp-PuU 
and SSCP-LU sessions 


Timing between sscp 
sessions and Lu-Lu 
session — SSCP session 
reset during LU-LU 
session activation 


Timing between sscp 
sessions and LU-LU 
session — sscPp session 
reset during LU-LU 
session deactivation 


For an Lu-Lu session, the Timing on LU-LU session 
DATATRAFFIC_RCV is not active. traffic 


Should not occur — error 
in network 


Should not occur — error 
in network 


Segmenting length error Should not occur — error 
in network 

Queue freed — segmenting error Should not occur — error 
in network 
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Probable Causes of Discards 


Probable Cause 


Timing on LU-LU 
session traffic 


Timing between ssce 
sessions and Lu-LU 
session 


Timing between 
SSCP-PU and SSCP-LU 
sessions 


Post-failure traffic 
ourge 


Should not occur 


Explanation of Cause 


This discard can occur on the session between the application program and 
the stu. It is usually caused by a reset request (for example, a Clear ora 
BIND) from the application program. This type of discard does not usually 
cause a problem in the network. 


This discard usually occurs when a reset of the SSCP-PU or SSCP-LU session 
affects a pending initiation or termination of the Lu-LU session. For example, if 
the application program issues a CLSDST request to the logical unit, VTAM 
sends an UNBIND request to the logical unit. If the sscp-LU session fails before 
the UNBIND response comes back, the UNBIND response is discarded. This type 
of discard does not usually cause a problem in the network. 


This discard usually occurs when a reset of the sscp-Pu session affects a 
pending initiation or termination of the SScP-LU session. For example, if the 
operator deactivates the logical unit, vtAmM sends a DACTLU to the logical unit. 

If the sscp-pu session fails before the DACTLU response comes back, the DACTLU 
response is discarded. This type of discard does not cause a problem in the 
network. 


This discard may be caused by a network failure. Any piu traffic arriving after 
the network failure but before the session is terminated can be purged using 
the discard function. For example, after a channel i/o error, Pius that continue 
to be queued outbound over the channel can be discarded. This type of 
discard does not usually cause a problem in the network. 


This discard indicates a hardware or software error in the network; it usually 
occurs after a major SNA protocol violation. For example, if VTAM is waiting for 
a sequence number of 0008 but receives a Piu with sequence number 0010, 
Pius with sequence numbers 0008 and 0009 are missing. The missing Plus 
could have been lost anywhere in the session path, or perhaps they were not 
sent. The logical unit, physical unit, line, Ncp, channel, or VTAM might be 
responsible for the problem. 


Further investigation is usually required to determine where in the network 
the problem is. The session type and reason code determine what type of 
documentation is needed to resolve a problem identified by this discard code. 


Figure 181. Probable Causes of Discards 
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RUPE. Request/response unit processing element. 
SAB. Service application block. 

SADP. Serviceability aids and debugging procedures. 
SAF. Source address field. 

SAW. Session awareness. 

SBA. Set buffer address. 

SC. Session control. 

SCF. Secondary control field. 


SCT. Section control table. 
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SDA. Sense data included. 

SDB. Storage descriptor block. 

SDF. Serial data field. 

SDLC. Synchronous Data Link Control. 
SDT. Start data traffic. 

SDVT. Skeleton destination vector table. 
SDWA. System diagnostic work area. 
SESSEND. Session ended. 

SESSER. Session serialization. 
SESSST. Session started. 

SIB. Session information block. 

SiO. Start I/O. 

SIT. Scanner interface trace. 

SLT. Section list table. 

SLU. Secondary logical unit. 

SMF. System management facility. 
SMP. System Modification Program. 
SMPIE. System Modification Program Extended. 
SMS. Storage management services. 
SNA. Systems Network Architecture. 
SNI. SNA network interconnection. 

SP. Service point. 

SPANC. Storage pool anchor block. 
SPCS. Service point command service. 
SRT. Symbol resolution table. 

SRTD. Symbol resolution table directory. 
SRTE. Symbol resolution table entry. 
SS. Start-stop. 

SSCP. System services control point. 
SSP. System Support Programs. 


STD. Set contro! vector time and date. 
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STSN. Set and test sequence numbers. 
SVA. Shared virtual area. 

SVC. Switched virtual circuit. 

SWB. Save/Work block. 

SYSDEF. System definition. 

SYSREC. System error file. 

TAB. Terminal anchor block. 

TAP. Trace analysis program. 

TC. Transmission control. 

TCAM. Telecommunications Access Method. 
TCAS. Terminal control address space. 
TCB. Task control block. 

TECT. Temporary error counter. 

TG. Transmission group. 

TH. Transmission header. 

TIB. Task information block. 

TIC. Token-ring interface coupler. 

TID. Task identifier. 

TIK. Task identification key. 

TL. Test loop. 

TNSTAT. Tuning statistics. 

TP. Transmission priority. 


TPRINT. Trace print. 


TR. Trace. 


TRAC. Trace record. 

TRCPL. Trace parameter list. 

TRFILE. Trace file. 

TSC. Transmission subsystem component. 
TSCB. Transmission subsystem control block. 


TSO. Time sharing option. 
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TSO/VTAM. Time sharing option for VTAM. 
TSPL. Transmission subsystem parameter list. 
TT. Test terminal. 

TWA. Test work area. 

TWX. Teletypewriter exchange service. 
UECB. User exit control block. 

UGB. Utilities services task global block. 
USS. Unformatted system services. 

VEIB. Virtual external interrupt block. 
VGB. VTAM services global block. 

VIT. VTAM internal trace. 

VLB. VTAM services loca! block. 

VM. Virtual Machine operating system. 


VM/SP. Virtual Machine/System Product operating 
system. 


VP. Variable pageable. 
VR. Virtual route. 


VS. Virtual storage. 
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VSAM. Virtual Storage Access Method. 
VSCS. VM SNA console support. 
VSE. Virtual Storage Extended operating system. 


VSE/AF. Virtual Storage Extended/Advanced Functions 
operating system. 


VSE/SP. Virtual Storage Extended/System Package 
operating system. 


VSM. VTAM service machine. 

VTAM. Virtual Telecommunications Access Method. 
VTIOC. VTAM Terminal !/O Coordinator. 

WEB. Work element block. 

WRE. Waiting request element. 

XID. Exchange identification. 

XMT. Transmit buffer information. 

XREF. cross-reference. 

XRF. Extended recovery facility. 

X.21. Recommendation X.21 (Geneva 1980) 


X.25. | Recommendation X.25 (Geneva 1980) 
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Glossary 


This glossary defines important NCP, NetView, 
NetView/PC, SSP, and VTAM abbreviations and terms. 
It includes information from the /BM Vocabulary for 
Data Processing, Telecommunications, and Office 
Systems, GC20-1699. Definitions from the American 
National Dictionary for Information Processing are 
identified by an asterisk (*). Definitions from draft pro- 
posals and working papers under development by the 
International Standards Organization, Technical Com- 
mittee 97, Subcommittee 1 are identified by the symbol 
(TC97). Definitions from the CCIT Sixth Plenary 
Assembly Orange Book, Terms and Definitions and 
working documents published by the Consultative Com- 
mittee on International Telegraph and Telephone of the 
International Telecommunication Union, Geneva, 1980 
are preceded by the symbol (CCITT/ITU). Definitions 
from published sections of the {SO Vocabulary of Data 
Processing, developed by the International Standards 
Organization, Technical Committee 97, Subcommittee 1 
and from published sections of the [SO Vocabulary of 
Office Machines, developed by subcommittees of ISO 
Technical Committee 95, are preceded by the symbol 
(ISO). 


For abbreviations, the definition usually consists only of 
the words represented by the letters; for complete defi- 
nitions, see the entries for the words. 


Reference Words Used in the Entries 
The following reference words are used in this 


glossary: 


Deprecated term for. Indicates that the term 
should not be used. It refers to a preferred term, 
which is defined. 


Synonymous with. Appears in the commentary of 
a preferred term and identifies tess desirable or 
less specific terms that have the same meaning. 


Synonym for. Appears in the commentary of a less 
desirable or less specific term and identifies the 
preferred term that has the same meaning. 


Contrast with. Refers to a term that has an 
opposed or substantively different meaning. 


See. Refers to multiple-word terms that have the 
same last word. 


See also. Refers to related terms that have similar 
(but not synonymous) meanings. 


abend. Abnormal end of task. 
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abnormal end of task (abend). Termination of a task 
before its completion because of an error condition that 
cannot be resolved by recovery facilities while the task 
is executing. 


ACB. (1) In VTAM, application control block. (2) In 
NCP, adapter control block. 


ACB name. (1) The name of an ACB macroinstruction. 
(2) Aname specified in the ACBNAME parameter of a 
VTAM APPL statement. Contrast with network name. 


accept. For a VTAM application program, to establish a 
session with a logical unit (LU) in response to a CINIT 
request from a system services control point (SSCP). 
The session-initiation request may begin when a ter- 
minal user logs on, a VTAM application program issues 
a macroinstruction, or a VTAM operator issues a 
command. See also acquire (1). 


access method. A technique for moving data between 
main storage and input/output devices. 


accounting exit routine. In VTAM, an optional installa- 
tion exit routine that collects statistics about session 
initiation and termination. 


- ACF. Advanced Communications Function. 


ACF/NCP. Advanced Communications Function for the 
Network Control Program. Synonym for NCP. 


ACF/SSP. Advanced Communications Function for the 
System Support Programs. Synonym for SSP. 


ACF/TAP. Advanced Communications Function for the 
Trace Analysis Program. Synonym for TAP. 


ACF/TCAM. Advanced Communications Function for 
the Telecommunications Access Method. Synonym for 
TCAM. 


ACF/VTAM. Advanced Communications Function for 
the Virtual Telecommunications Access Method. 
Synonym for VTAM. 


acquire. (1) For a VTAM application program, to ini- 
tiate and establish a session with another logical unit 
(LU). The acquire process begins when the application 
program issues a macroinstruction. See also accept. 
(2) To take over resources that were formerly con- 
trolled by an access method in another domain, or to 
resume control of resources that were controlled by 
this domain but released. Contrast with release. See 
also resource takeover. 


Glossary 683 


activate. To make a resource of a node ready to 
perform the functions for which it was designed. Con- 
trast with deactivate. 


active. (1) The state a resource is in when it has been 
activated and is operational. Contrast with inactive, 
pending, and inoperative. (2) Pertaining to a major or 
minor node that has been activated by VTAM. Most 
resources are activated as part of VTAM start proc- 
essing or as the result of a VARY ACT command. 


active application. The application subsystem currently 
in an extended recovery facility (XRF) session with a 
terminal user. See alternate application. 


adapter. Hardware card that allows a device, such as a 
PC, to communicate with another device, such as a 
monitor, a printer, or other I/O device. 


adapter control block (ACB). In NCP, a control block 
that contains line control information and the states of 
I/O operations for BSC lines, SS lines, or SDLC links. 


adaptive session pacing. Synonym for adaptive 
session-level pacing. 


adaptive session-level pacing. A form of session-level 
pacing in which session components exchange pacing 
windows that may vary in size during the course of a 
session. This allows transmission to adapt dynamically 
to variations in availability and demand of buffers on a 
session by session basis. Session pacing occurs 
within independent stages along the session path 
according to local congestion at the intermediate 
nodes. Synonymous with adaptive session pacing. 
See pacing, session-level pacing, and virtual route 
pacing. 


address transiation. See network address translation. 


adjacent networks. Two SNA networks joined by a 
common gateway NCP. 


adjacent nodes. Two nodes that are connected by one 
or more data links with no intervening nodes. 


Advanced Communications Function (ACF). A group of 
IBM licensed programs (principally VTAM, TCAM, NCP, 
and SSP) that use the concepts of Systems Network 
Architecture (SNA), including distribution of function 
and resource sharing. 


Advanced Program-to-Program Communication 
(APPC). A synonym for logical unit (LU) 6.2 and its 
implementations. 

\ 
alert. (1) In SNA, a record sent to a system problem 
management focal point to communicate the existence 
of an alert condition. (2) In the NetView program, a 
high priority event that warrants immediate attention. 
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This data base record is generated for certain event 
types that are defined by user-constructed filters. 


alert condition. A problem or impending problem for 
which some or all of the process of problem determi- 
nation, diagnosis, and resolution is expected to require 
action at a control point. 


alias name. A name defined in a host used to repre- 
sent a logical unit name, logon mode table name, or 
class-of-service name in another network. This name 
is defined to a name translation program when the 
alias name does not match the real name. The alias 
name translation program is used to associate the real 
and alias names. 


allocate. A logical unit (LU) 6.2 application program 
interface (API) verb used to assign a session to a con- 
versation for the conversation’s use. Contrast with 
deallocate. 


alternate application. The subsystem that is prepared 
to take over a particular active application’s extended 
recovery facility (XRF) sessions with terminal users in 
case the application fails. See active application. 


API. Application program interface. 
APPC. Advanced Program-to-Program Communication. 


application contro! block (ACB). A control block that 
links an application program to VSAM or VTAM. 


application program. (1) A program written for or by a 
user that applies to the user’s work. (2) A program 
used to connect and communicate with stations in a 
network, enabling users to perform application-oriented 
activities. 


application program exit routine. in VTAM, a user- 
written exit routine that performs functions for a partic- 
ular application program and is run as part of the 
application program. Examples are the RPL exit 
routine, the EXLST exit routine, and the TESTCB exit 
routine. Contrast with installation exit routine. 


application program interface (API). (1) The formally 
defined programming language interface between an 
IBM system control program or licensed program and 
its user. (2) The interface through which an application 
program interacts with an access method. In VTAM, it 
is the language structure used in control blocks so that 
application programs can reference them and be identi- 
fied to VTAM. 


application program major node. A group of applica- 
tion program minor nodes. In the VTAM definition 
library, it is a member, book, or file that contains one 
or more APPL statements, which represent application 
programs. In MVS, it is a member of the library; in 
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VSE, it is a book; and in VM, it is a CMS file of filetype 
VTAMLST. 


ASCH. American National Standard Code for Informa- 
tion Interchange. 


asynchronous operation. Simultaneous operations of 
software or hardware. In software, an operation, such 
as a request for session establishment or data transfer, 
in which the application program is allowed to continue 
execution while the operation is performed. The 
access method informs the application program after 
the operation is completed. Contrast with synchronous 
operation. 


asynchronous request. In VTAM, a request for an asyn- 
chronous operation. Contrast with synchronous 
request. 


authorization exit routine. In VTAM, an optional! instal- 
lation exit routine that approves or disapproves 
requests for session initiation. 


authorized path. In VTAM for MVS, a facility that 
enables an application program to specify that a data 
transfer or related operation be carried out in a privi- 
leged and more efficient manner. 


automatic logon. (1) A process by which VTAM auto- 
matically creates a session-initiation request to estab- 
lish a session between two logical units (LUs). The 
session will be between a designated primary logical 
unit (PLU) and a secondary logical unit (SLU) that is 
neither queued for nor in session with another PLU. 
See also controlling application program and control- 
ling logical unit. (2) In VM, a process by which a 
virtual machine is initiated by other than the user of 
that virtual machine. For example, the primary VM 
operator’s virtual machine is activated automatically 
during VM initialization. 


available. In VTAM, pertaining to a logical unit that is 
active, connected, enabled, and not at its session limit. 


back-level. Pertaining to an earlier release of an IBM 
product, which may not support a particular, current 
function. 


backup session. The session that replaces the failing 
primary extended recovery facility (XRF) session 
between a terminal user and the active subsystem. 


basic conversation. A conversation that supports the 
_functions of the basic conversation protocol boundary 
defined by LU 6.2. That format requires data to be sent 
as logical records consisting of a 2-byte length prefix 
followed by the data. See also mapped conversation. 


basic information unit (BIU). In SNA, the unit of data 
and control information that is passed between half- 
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sessions. It consists of a request/response header 
(RH) followed by a request/response unit (RU). 


basic transmission unit (BTU). In SNA, the unit of data 
and control information passed between path control 
components. A BTU can consist of one or more path 
information units (PIUs). See also blocking of PiUs. 


begin bracket. In SNA, the value (binary 1) of the 
begin-bracket indicator in the request header (RH) of 
the first request in the first chain of a bracket; the value 
denotes the start of a bracket. Contrast with end 
bracket. See also bracket. 


bidder. In SNA, the LU-LU half-session defined at 
session activation as having to request and receive 
permission from the other LU-LU half-session to begin 
a bracket. Contrast with first speaker. See also 
bracket protocol and contention. 


binary synchronous communication (BSC). (1) Com- 
munication using binary synchronous line discipline. 
(2) A uniform procedure, using a standardized set of 
control characters and control character sequences, for 
synchronous transmission of binary-coded data 
between stations. 


bind. In SNA, a request to activate a session between 
two logical units (LUs). See also session activation 
request. Contrast with UNBIND. 


BIU. Basic information unit. 


BIU segment. In SNA, the portion of a basic information 
unit (BIU) that is contained within a path information 
unit (PIU). It consists of either a request/response 
header (RH) followed by all or a portion of a 
request/response unit (RU), or only a portion of an RU. 


blocking of PIUs. In SNA, an optional function of path 
contro! that combines multiple path information units 
(PIUs) into a single basic transmission unit (BTU). 


BNN. Boundary network node. 


boundary function. (1) A capability of a subarea node 
to provide protocol support for attached peripheral 
nodes, such as: (a) interconnecting subarea path 
control and peripheral path control elements, (b) per- 
forming session sequence numbering for low-function 
peripheral nodes, and (c) providing session-level 
pacing support. (2) The component that provides these 
capabilities. See also boundary node, network 
addressable unit (NAU), peripheral path control, 
Subarea node, and subarea path control. 


boundary network node (BNN). Deprecated term for 
boundary node. 


boundary node. (1) A subarea node with boundary 
function. See subarea node (including illustration). 
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See also boundary function. (2) The programming 
component that performs FID2 (format identification 
type 2) conversion, channel data link control, pacing, 
and channel or device error recovery procedures for a 
locally attached station. These functions are similar to 
those performed by a network contro! program for an 
NCP-attached station. 


bracket. In SNA, one or more chains of request units 
(RUs) and their responses that are exchanged between 
the two LU-LU half-sessions and that represent a trans- 
action between them. A bracket must be completed 
before another bracket can be started. Examples of 
brackets are data base inquiries/replies, update trans- 
actions, and remote job entry output sequences to work 
stations. See also begin bracket and end bracket. 


bracket protocol. In SNA, a data flow control protocol 
in which exchanges between the two LU-LU half- 
sessions are achieved through the use of brackets, with 
one LU designated at session activation as the first 
speaker and the other as the bidder. The bracket pro- 
tocol involves bracket initiation and termination rules. 
See also bidder and first speaker. 


BSC. Binary synchronous communication. 
BTU. Basic transmission unit. 


buffer. A portion of storage for temporarily holding 
input or output data. 


cancel closedown. A closedown in which VTAM is 
abnormally terminated either because of an unex- 
pected situation or as the result of an operator 
command. See also orderly closedown and quick 
closedown. 

CCP. Configuration control program facility. 

CCS. Console communication services. 

CDRM. Cross-domain resource manager. 

CORSC. Cross-domain resource. 

chain. See RU chain. 

channel. * A path along which signals can be sent, for 
example, data channel, output channel. See data 
channel and input/output channel. See also fink. 
channel adapter. A communication controller hard- 
ware unit used to attach the controller to a System/360 
or a System/370 channel. 

channel-attached. Pertaining to the attachment of 


devices directly by System 370 input-output channels to 
a host processor. 


686  VTAM Diagnosis 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


channel-attachment major node. (1) A major node that 
includes an NCP that is channel-attached to a data host. 
(2) A major node that may include minor nodes that 
are the line groups and lines that represent a channel 
attachment to an adjacent (channel-attached) host. 

(3) In VM or VSE operating systems, a major node that 
may include minor nodes that are resources (host 
processors, NCPs, line groups, lines, SNA physical 
units and logical units, cluster controllers, and termi- 
nals) attached through a communication adapter. 


channel link. A System/370 I/O channel to control unit 
interface that has an SNA network address. A channel 
link can be either a subarea link or a peripheral link. 
See also link and subarea link. 


character-coded. Synonym for unformatted. 
CICS. Customer Information Control System. 
CID. Communication identifier. 


CINIT. A network services request sent from a system 
services control point (SSCP) to a logical! unit (LU) 
asking that LU to establish a session with another LU 
and to act as the primary end of the session. 


class of service (COS). In SNA, a designation of the 
path control network characteristics, such as path 
security, transmission priority, and bandwidth, that 
apply to a particular session. The end user designates 
class of service at session initiation by using a sym- 
bolic name that is mapped into a list of virtual routes, 
any one of which can be selected for the session to 
provide the requested level of service. 


cleanup. A network services request, sent by a system 
services control unit (SSCP) to a logical unit (LU), that 
causes a particular LU-LU session with that LU to be 
ended immediately and without the participation of 
either the other LU or its SSCP. 


clear data. Data that is not enciphered. Synonymous 
with plaintext. 


clear session. A session in which only clear data is 
transmitted or received. Contrast with cryptographic 
session. 


closedown. The deactivation of a device, program, or 
system. See cance/ closedown, orderly closedown, 
and quick closedown. 


cluster controller. A device that can control the 
input/output operations of more than one device con- 
nected to it. A cluster controller may be controlled by a 
program stored and executed in the unit; for example, 
the IBM 3601 Finance Communication Controller. Or it 
may be controlled entirely by hardware; for example, 
the IBM 3272 Control Unit. 
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CMS. Conversational Monitor System. 
CNM. Communication network management. 
CNOS. Change number of sessions. 


code point. In the NetView/PC program and in the 
NetView program, a 1- or 2-byte hexadecimal value that 
indexes a text string stored at an alert receiver and is 
used by the alert receiver to create displays of alert 
information. 


command. (1) A request from a terminal for the per- 
formance of an operation or the execution of a partic- 
ular program. (2) In SNA, any field set in the 
transmission header (TH), request header (RH), and 
sometimes portions of a request unit (RU), that initiates 
an action or that begins a protocol; for example: (a) 
Bind Session (session-control request unit), a 
command that activates an LU-LU session, (b) the 
change-direction indicator in the RH of the last RU of a 
chain, (c) the virtual route reset window indicator in a 
FID4 transmission header. See also VTAM operator 
command. 


command facility. The component of the NetView 
program that is a base for command processors that 
can monitor, control, automate, and improve the opera- 
tion of a network. 


command list (CLIST). In the NetView program, a 
sequential list of commands and control statements 
that is assigned a name. When the name is invoked (as 
a command) the commands in the list are executed. 


corimand processor. A program that performs an 
operation specified by a command. 


communication adapter. An optional hardware feature, 
available on certain processors, that permits communi- 
cation lines to be attached to the processors. 


communication control unit. A communication device 
that controls the transmission of data over lines ina 
network. Communication control units include trans- 
mission control units (such as the 2702 Transmission 
Control Unit) and communication controllers (such as 
the 3720 or 3725). 


communication controller. A type of communication 
control unit whose operations are controlled by one or 
more programs stored and executed in the unit; for 
example, the IBM 3725 Communication Controller. It 
manages the details of line control and the routing of 
data through a network. 


communication identifier (CID). In VTAM, a key for 
locating the control blocks that represent a session. 
The key is created during the session-establishment 
procedure and deleted when the session ends. 
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communication line. Deprecated term for telecommu- 
nication line and transmission line. 


communication management configuration (CMC). 

(1) In VTAM, a technique for configuring a network that 
allows for the consolidation of many network manage- 
ment functions for the entire network in a single host 
processor. (2) A multiple-domain network configura- 
tion in which one of the hosts, called the communi- 
cation management configuration host, performs most 
of the controlling functions for the network, thus 
allowing the other hosts, called data hosts, to process 
applications. This is accomplished by configuring the 
network so that the communication management host 
owns most of the resources in the network that are not 
application programs. The resources that are not 
owned by the communication management host are the 
resources that are channel-attached stations of data 
hosts. 


communication management configuration host node. 
The type 5 host processor in a communication manage- 
ment configuration that does all network-control func- 
tions in the network except for the control of devices 
channel-attached to data hosts. Synonymous with com- 
munication management host. Contrast with data host 
node. 


communication management host. Synonym for com- 
munication management configuration host node. Con- 
trast with data host. 


communication network management (CNM). The 
process of designing, installing, operating, and man- 
aging the distribution of information and controls 
among end users of communication systems. 


communication network management (CNM) applica- 
tion program. A VTAM application program that issues 
and receives formatted management services request 
units for physical units. For example, NetView. 


communication network management (CNM) interface. 
The interface that the access method provides to an 
application program for handling data and commands 
associated with communication system management. 
CNM data and commands are handled across this inter- 
face. 


communication network management (CNM) processor. 
A program that manages one of the functions of a com- 
munications system. A CNM processor is executed 
under control of NetView. 


communication scanner processor (CSP). A processor 
in the 3725 Communication Controller that contains a 
microprocessor with control code. The code controls 
transmission of data over links attached to the CSP. 


composite end node (CEN). A group of nodes made up 
of a single type 5 node and its subordinate type 4 nodes 
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that together support type 2.1 protocols. To a type 2.1 
node, a CEN appears as one end node. For example, 
NCP and VTAM act as a composite end node. 


configuration. (1) (TC97) The arrangement of a com- 
puter system or network as defined by the nature, 
number, and the chief characteristics of its functional 
units. The term may refer to a hardware or a software 
configuration. (2) The devices and programs that 
make up a system, subsystem, or network. (3) In CCP, 
the arrangement of controllers, lines, and terminals 
attached to an IBM 3710 Network Controller. Also, the 
collective set of item definitions that describe such a 
configuration. 


configuration contro! program (CCP) facility. An SSP 
interactive application program facility by which config- 
uration definitions for the IBM 3710 Network Controller 
can be created, modified, and maintained. 


configuration services. In SNA, one of the types of 
network services in the control point (CP) and in the 
physical unit (PU); configuration services activate, 
deactivate, and maintain the status of physical units, 
links, and link stations. Configuration services also 
shut down and restart network elements and modify 
path control routing tables and address-translation 
tables. See also maintenance services, management 
services, network services, and session services. 


connected. In VTAM, pertaining to a physical unit (PU) 
or logical unit (LU) that has an active physical path to 
the host processor containing the system services 
control point (SSCP) that controls the PU or LU. 


connection. Synonym for physical connection. 


console communications services (CCS). The SNA 
facility that acts as an interface between the contro! 
program and the VSCS component of VTAM for VM. 


contention. A situation in which two logical units (LUs) 
that are connected by an LU 6.2 session both attempt to 
allocate the session for a conversation at the same 
time. The control operator assigns “winner” and 
“loser” status to the LUs so that processing may con- 
tinue on an orderly basis. The contention loser 
requests permission from the contention winner to allo- 
cate a conversation on the session, and the contention 
winner either grants or rejects the request. See also 
bidder. 


control block. (ISO) A storage area used by a computer 
program to hold control information. 


control operator. For logical unit (LU) 6.2, a service 
transaction program that describes and controls the 
availability of certain resources. For example, it 
describes network resources accessed by the local LU 
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and it controls session limits between the LU and its 
partners. See also contention. 


control point (CP). (1) A system services control point 
(SSCP) that provides hierarchical control of a group of 
nodes in a network. (2) Acontrol point (CP) local to a 
specific node that provides control of that node, either 
in the absence of SSCP control (for type 2.1 nodes 
engaged in peer to peer communication) or to supple- 
ment SSCP control. 


control program (CP). The VM operating system that 
manages the real processor’s resources and is respon- 
sible for simulating System/370s for individual users. 


controlling application program. In VTAM, an applica- 
tion program with which a secondary logical unit (other 
than an application program) is automatically put in 
session whenever the secondary logical unit is avail- 
able. See also automatic logon and controlling logical 
unit. 


controlling logical unit. In VTAM, a logical unit with 
which a secondary logical unit (other than an applica- 
tion program) is automatically put in session whenever 
the secondary logical unit is available. A controlling 
logical unit can be either an application program or a 
device-type logical unit. See also automatic logon and 
controlling application program. 


control statement. A statement in a command list that 
controls the processing sequence of the command list 
or allows the command list to send messages to the 
operator and receive input from the operator. 


conversation. |n SNA, a logical connection between 
two transaction programs using an LU 6.2 session. 
Conversations are delimited by brackets to gain exclu- 
sive use of a session. 


Conversational Monitor System (CMS). A VM applica- 
tion program for general interactive time sharing, 
problem solving, and program development. 


converted command. An intermediate form of a 
character-coded command produced by VTAM through 
use of an unformatted system services definition table. 
The format of a converted command is fixed; the unfor- 
matted system services definition table must be con- 
structed in such a manner that the character-coded 
command (as entered by a logical unit) is converted 
into the predefined, converted command format. See 
also unformatted. 


COS. Class of service. 
coupler. A hardware device that connects a modem to 
a public phone system in much the same way that a 


telephone does. 


CP. (1) Control program. (2) Control point. 
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cross-domain. In SNA, pertaining to control of 
resources involving more than one domain. 


cross-domain resource (CDRSC). A resource owned by 
a cross-domain resource manager (CDRM) in another 
domain but known by the CDRM in this domain by 
network name and associated CDRM. 


cross-domain resource manager (CDRM). In VTAM, 
the function in the system services control point (SSCP) 
that controls initiation and termination of cross-domain 
sessions. 


cross-network. In SNA, pertaining to control or 
resources involving more than one SNA network. 


cross-network LU-LU session. In SNA, a session 
between logical units (LUs) in different networks. 


cross-network session. An LU-LU or SSCP-SSCP 
session whose path traverses more than one SNA 
network. 


CRV. Cryptography verification. 


cryptographic. Pertaining to the transformation of data 
to conceal its meaning. See also encipher and deci- 
pher. 


cryptographic session. In SNA products, an LU-LU 
session in which a function management data (FMD) 
request may be enciphered before it is transmitted and 
deciphered after it is received. Contrast with clear 
session. See required cryptographic session and 
selective cryptographic session. 


cryptographic session key. In SNA, deprecated term 
for session cryptography key. 


cryptography verification (CRV) request. A request unit 
sent by the primary logical unit (PLU) to the secondary 
logical unit (SLU) as part of cryptographic session 
establishment, to allow the SLU to verify that the PLU is 
using the correct cryptographic session key. 


CSP. Communication scanner processor. 


Customer Information Control System (CICS). A 
licensed program that enables transactions entered at 
remote terminals to be processed concurrently by user- 
written application programs. It also includes facilities 
for building, using, and maintaining data bases. 


DAF. Destination address field. 


data channel. Synonym for input/output channel. See 
channel. 


data check. An indication that a transmission is faulty. 


For example, in SDLC a frame check sequence (FCS) 
error. 
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data circuit-terminating equipment (DCE). (TC97) The 
equipment installed at the user’s premises that pro- 
vides all functions required to establish, maintain, and 
terminate a connection, and the signal conversion and 
coding between the data terminal equipment (DTE) and 
the line. The DCE may be separate equipment or an 
integral part of other equipment. 


data-encrypting key. A key used to encipher and deci- 
pher data transmitted in a cryptographic session. Con- 
trast with Aey-encrypting key. See session 
cryptography key. 


data flow control (DFC). In SNA, a request/response 
unit (RU) category used for requests and responses 
exchanged between the data flow control layer in one 
half-session and the data flow control layer in the 
session partner. 


data flow control (DFC) layer. In SNA, the layer within 
a half-session that (1) controls whether the half-session 
can send, receive, or concurrently send and receive 
request units (RUs); (2) groups related RUs into RU 
chains; (3) delimits transactions via the bracket pro- 
tocol; (4) controls the interlocking of requests and 
responses in accordance with control modes specified 
at session activation; (5) generates sequence numbers; 
and (6) correlates requests and responses. 


data flow control (DFC) protocol. In SNA, the 
sequencing rules for requests and responses by which 
network addressable units (NAUs) in a session coordi- 
nate and control data transfer and other operations. 
For example, see bracket protocol. 


data host. Synonym for data host node. Contrast with 
communication management configuration host. 


data host node. In a communication management con- 
figuration, a type 5 host node that is dedicated to proc- 
essing applications and does not control network 
resources, except for its channel-attached or communi- 
cation adapter-attached devices. Synonymous with 
data host. Contrast with communication management 
configuration host node. 


data link. In SNA, synonym for fink. 


data link control (DLC) layer. In SNA, the layer that 
consists of the link stations that schedule data transfer 
over a transmission medium connecting two nodes and 
perform error control for the tink connection. Examples 
of data link contro! are SDLC for serial-by-bit link con- 
nection and data link control for the System/370 
channel. 


data link control protocol. In SNA, a set of rules used 
by two nodes on a data link to accomplish an orderly 
exchange of information. Synonymous with /ine 
control. 
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data terminal equipment (DTE). (TC97) That part of a 
data station that serves as a data source, data link, or 
both, and provides for the data communication control 
function according to protocols. 


data types. In the NetView program, a concept to 
describe the organization of panels. Data types are 
defined as alerts, events, and statistics. Data types are 
combined with resource types and display types to 
describe NetView’s display organization. See also 
display types and resource types. 


DBCS. Doublie-byte character set. 
DCE. Data circuit-terminating equipment. 


deactivate. To take a resource of a node out of service, 
rendering it inoperable, or to place it in a state in which 
it cannot perform the functions for which it was 
designed. Contrast with activate. 


deallocate. A logical unit (LU) 6.2 application program 
interface (API) verb that terminates a conversation, 
thereby freeing the session for a future conversation. 
Contrast with allocate. 


decipher. To convert enciphered data into clear data. 
Contrast with encipher. Synonymous with decrypt. 


decrypt. To convert encrypted data into clear data. 
Contrast with encrypt. Synonym for decipher. 


decryption. The unscrambling of data using an algo- 
rithm which works under the control of a key. The key 
allows data to be protected even when the algorithm is 
unknown. Data is unscrambled after transmission. 
Contrast with encryption. 


definite response (DR). In SNA, a value in the form-of- 
response-requested field of the request header. The 
value directs the receiver of the request to return a 
response unconditionally, whether positive or negative, 
to that request. Contrast with exception response and 
no response. 


definition statement. (1) In VTAM, the statement that 
describes an element of the network. (2) In NCP, a 
type of instruction that defines a resource to the NCP. 
See Figure 182, Figure 183, and Figure 184. See also 
macroinstruction. | 
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operands 
suboperands suboperands 
START A,{B,C), KEYWORD1=0, KEYWORD2=(E,F) 
statement positional keyword 
identifier operands operands 
statement 


Figure 182. Example of a Language Statement 


definition statement 


suboperands 
BUILO CA=(caQ[,cal][,ca2][,ca3}) 
definition keyword 
statement operand 


identifier 


Figure 183. NCP Examples 


definition keyword operand 

statement 

identifier suboperands 
PU OISCNT=([YES|NO}[,FINFJ) 


definition statement 


VARY NET,ACT, IDsname ,RNAME=(namel,...,namel3) 
L—_—_ 


operator positional suboperands 


command operands 
operator 
operands 


operator command 


Figure 184. VTAM Examples 


definition statement identifier. A specific character 
string that identifies the purpose of a definition state- 
ment. 


dependent LU. Any logical unit (LU) that receives an 
ACTLU over a link. Such LUs can act only as sec- 
ondary logical units (SLUs) and can have only one 
LU-LU session at a time. Contrast with independent 
LU. 


destination address field (DAF). In SNA, a fleld ina 


FIDO or FID1 transmission header that contains the 
network address of the destination. 
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destination logical unit (DLU). The logical unit to which 
data is to be sent. Contrast with origin logical unit 
(OLU). 


device-type logical unit. [n VTAM, a logical unit that 
has a session limit of 1 and usually acts as the sec- 
ondary end of a session. It is typically a logical unit 
(LU) in an SNA terminal, such as a 3270. It could be the 
primary end of a session, for example, the logical unit 
representing the Network Routing Facility (NRF) logical 
unit. 


DFC. Data flow control. 


dial-in. Refers to the direction in which a switched con- 
nection is requested by any node or terminal other than 
the receiving host or an NCP. 


dial-out. Refers to the direction in which a switched 
connection is requested by a host or an NCP. 


directory. In VM, a control program (CP) disk that 
defines each virtual machine’s normal configuration. 


disabied. In VTAM, pertaining to a logical unit (LU) that 
has indicated to its system services control point 
(SSCP) that it is temporarily not ready to establish 
LU-LU sessions. An initiate request for a session with 
a disabled logical unit (LU) can specify that the session 
be queued by the SSCP until the LU becomes enabled. 
The LU can separately indicate whether this applies to 
its ability to act as a primary logical unit (PLU) or a sec- 
ondary logical unit (SLU). See also enabled and inhib- 
ited. 


disconnection. The termination of a physical con- 
nection. 


display. (1) To present information for viewing, usually 
on a terminal screen or a hard-copy device. (2) A 
device or medium on which information is presented, 
such as a terminal screen. (3) Deprecated term for 
panel. 


display levels. Synonym for display types. 


display types. In NetView, a concept to describe the 
organization of panels. Display types are defined as 
total, most recent, user action, and detail. Display 
types are combined with resource types and data types 
to describe NetView’s panel organization. See data 
types and resource types. Synonymous with display 
levels. 


DLC. Data link control. 
DLU. Destination logical unit. 
domain. (1) An access method, its application pro- 


grams, communication controllers, connecting lines, 
modems, and attached terminals. (2) In SNA, a system 
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services control point (SSCP) and the physical units 
(PUs), logical units (LUs), links, link stations, and all the 
associated resources that the SSCP has the ability to 
control by means of activation requests and deacti- 
vation requests. See system services control point 
domain and type 2.1 node control point domain. See 
also single-domain network and multiple-domain 
network 


domain operator. In a multiple-domain network, the 
person or program that controls the operation of the 
resources controlled by one system services control 
point. Contrast with network operator (2). 


double-byte character set (DBCS). A set of graphic 
characters where two bytes are used to represent the 
character set of such languages as Chinese and 
Japanese. The shift-in (SI) and shift-out (SO) control 
codes are used when DBCS is mixed with standard 
one-byte character sets. 


downstream. In the direction of data flow from the host 
to the end user. Contrast with upstream. 


downstream device. For the IBM 3710 Network Con- 
troller, a device located in a network such that the 3710 
is positioned between the device and a host. A display 
terminal downstream from the 3710 is an example of a 
downstream device. Contrast with upstream device. 


downstream line. For the IBM 3710 Network Controller, 
a telecommunication line attaching a downstream 
device to a 3710. Contrast with upstream line. 


Downstream Load Utility (DSLU). A licensed program 
that uses the communication network management 
(CNM) interface to support the load requirements of 
certain type 2 physical units, such as the IBM 3644 
Automatic Data Unit and the IBM 8775 Display Ter- 
minal. 


DR. (1) In NCP and CCP, dynamic reconfiguration. 
(2) In SNA, definite response. 


DARDS. Dynamic reconfiguration data set. 
DTE. Data terminal equipment. 


dump. (1) Computer printout of storage. (2) To write 
the contents of all or part of storage to an external 
medium as a safeguard against errors or in connection 
with debugging. (3) (ISO) Data that have been dumped. 


duplex. * in data communication, pertaining to a simul- 
taneous two-way independent transmission in both 
directions. Synonymous with ful! duplex. Contrast with 
half duplex. 


dynamic reconfiguration (DR). The process of changing 


the network configuration (peripheral PUs and LUs) 
without regenerating complete configuration tables. 
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dynamic reconfiguration data set (DRDS). In VTAM, a 
data set used for storing definition data that can be 
applied to a generated communication controller con- 
figuration at the operator’s request. A dynamic recon- 
figuration data set can be used to dynamically add PUs 
and LUs, delete PUs and LUs, and move PUs. It is acti- 
vated with the VARY DRDS operator command. See 
also dynamic reconfiguration. 


EBCDIC. * Extended binary-coded decimal interchange 
code. A coded character set consisting of 8-bit coded 
characters. 


ECB. Event control block. 


echo. The return of characters to the originating SS 
device to verify that a message was sent correctly. 


echo check. A check to determine the correctness of 
the transmission of data in which the received data are 
returned to the source for comparison with the ori- 
ginally transmitted data. 


ED. Enciphered data. 


EIA. Electronic Industries Association. Provides inter- 
face standards for electrical and electronic equipment. 


element. (1) A field in the network address. (2) The 
particular resource within a subarea identified by the 
element address. See also subarea. 


element address. In SNA, a value in the element 
address field of the network address identifying a spe- 
cific resource within a subarea. See subarea address. 


emulation mode. The function of a network control 
program that enables it to perform activities equivalent 
to those performed by a transmission control unit. 
Contrast with network control mode. 


Emulation Program (EP). An IBM control program that 
allows a channel-attached 3705 or 3725 communication 
controller to emulate the functions of an IBM 2701 Data 
Adapter Unit, an IBM 2702 Transmission Control, or an 
IBM 2703 Transmission Control. See also network 
control program. 


enabled. In VTAM, pertaining to a logical unit (LU) that 
has indicated to its system services control point 


(SSCP) that it is now ready to establish LU-LU sessions. 


The LU can separately indicate whether this prevents it 
from acting as a primary logical unit (PLU) or as a sec- 
ondary logical unit (SLU). See also disabled and inhib- 
ited. 


encipher. (1) To scramble data or convert it, before 
transmission, to a secret code that masks the meaning 
of the data to any unauthorized recipient. (2) In VTAM, 
to convert clear data into enciphered data. Contrast 
with decipher. Synonymous with encrypt. 
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enciphered data (ED). Data whose meaning is con- 
cealed from unauthorized users. 


encrypt. Synonym for encipher. 


encryption. The scrambling or encoding of data using 
an algorithm which works under the control of a key. 
The key allows data to be protected even when the 
algorithm is unknown. Data is scrambled prior to 
transmission. Contrast with decryption. 


end bracket. In SNA, the value (binary 1) of the end 
bracket indicator in the request header (RH) of the first 
request of the last chain of a bracket; the value denotes 
the end of the bracket. Contrast with begin bracket. 
See also bracket. 


end-of-transmission (EOT). The specific character, or 
sequence of characters, that indicates no more data. 


end-of-transmission (EOT) handshaking. When a 3710 
sends EOT characters over an idle line and waits for 
return characters. If no EOT response is returned, the 
3710 breaks the session. 


end node. A type 2.1 node that does not provide any 
intermediate routing or session services to any other 
node. For example, APPC/PC is an end node. See 
composite end node, node, and type 2.7 node. 


end user. In SNA, the ultimate source or destination of 
application data flowing through an SNA network. An 
end user may be an application program or a terminal 
operator. 


entry point. An SNA node that provides distributed 
network management support. It may be a type 2, type 
2.1, type 4, or type 5 node. It sends SNA-formatted 
network management data about itself and the 
resources it controls to a focal point for centralized 
processing, and it receives and executes focal point ini- 
tiated commands to manage and control its resources. 


EOT. End-of-transmission. 
EP. Emulation Program. 
ER. (1) Explicit route. (2) Exception response. 


error-to-traffic (E/T). The number of temporary errors 
compared to the traffic associated with a resource. 


E/T. Error-to-traffic. 


event. (1) In the NetView program, a record indicating 
irregularities of operation in physical elements of a 
network. (2) An occurrence of significance to a task; 
typically, the completion of an asynchronous operation, 
such as an input/output operation. 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


“Restricted Materials of IBM" 
Licensed Materials — Property of IBM 


event control block (ECB). A control block used to rep- 
resent the status of an event. 


exception request (EXR). In SNA, a request that 
replaces another message unit in which an error has 
been detected. 


exception response (ER). In SNA, a value in the form- 
of-response-requested field of a request header (RH). 
An exception response is sent only if a request is unac- 
ceptable as received or cannot be processed. Contrast 
with definite response and no response. See also neg- 
ative response. 


exchange identification (XID). A data link control 
command and response passed between adjacent 
nodes that allows the two nodes to exchange identifica- 
tion and other information necessary for operation over 
the data link. 


EXEC. In a VM operating system, a user-written 
command file that contains CMS commands, other 
user-written commands, and execution control state- 
ments, such as branches. 


exit list (EXLST). in VSAM and VTAM, a control block 
that contains the addresses of routines that receive 
control when specified events occur during execution; 
for example, routines that handle session- 
establishment request processing or I/O errors. 


exit routine. Any of several types of special-purpose 
user-written routines. See accounting exit routine, 
authorization exit routine, logon-interpret routine, 
virtual route selection exit routine, EXLST exit routine, 
and RPL exit routine. 


EXLST exit routine. !n VTAM, a routine whose address 
has been placed in an exit list (EXLST) control block. 
The addresses are placed there with the EXLST macro- 
instruction, and the routines are named according to 
their corresponding operand; hence DFASY exit 
routine, TPEND exit routine, RELREQ exit routine, and 
so forth. All exit list routines are coded by the VTAM 
application programmer. Contrast with RPL exit 
routine. 


expedited flow. In SNA, a data flow designated in the 
transmission header (TH) that is used to carry network 
control, session control, and various data flow control 
request/response units (RUs); the expedited flow is 
separate from the normal flow (which carries primarily 
end-user data) and can be used for commands that 
affect the normal flow. Contrast with normal flow. 


explicit command. In the NetView program, using a 
direct command to start an operation or to request 
information instead of stepping through the panel hier- 
archy to do so. 
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explicit route (ER). In SNA, the path control network 
elements, including a specific set of one or more trans- 
mission groups, that connect two subarea nodes. An 
explicit route is identified by an origin subarea 
address, a destination subarea address, an explicit 
route number, and a reverse explicit route number. 
Contrast with virtual route (VR). See also path and 
route extension. 


explicit route length. [n SNA, the number of trans- 
mission groups in an explicit route. 


EXR. Exception request. 


extended recovery facility (XRF). Software designed to 
minimize the effect of failures in MVS, VTAM, the host 
processor, or IMS/VS on sessions between IMS/VS and 
designated terminals. It provides an alternate sub- 
system to take over failing sessions. 


FDX. Full duplex. 


feature. A particular part of an IBM product that a cus- 
tomer can order separately. 


FIC. First-in-chain. 
FID. Format identification. 


fleld-formatted. Pertaining to a request or response 
that is encoded into fields, each having a specified 
format such as binary codes, bit-significant flags, and 
symbolic names. Contrast with character-coded. 


field-formatted request. In SNA, a request that is 
encoded into fields, each having a specified format 
such as binary codes, binary counts, bit-significant 
flags, and symbolic names; a format indicator in the 
request/response header (RH) for the request is set to 
zero. Contrast with character-coded. 


tirst-in-chain (FIC). A request unit (RU) whose request 
header (RH) begin chain indicator is on and whose RH 
end chain indicator is off. See also RU chain. 


first speaker. In SNA, the LU-LU half-session defined at 
session activation as: (1) able to begin a bracket 
without requesting permission from the other LU-LU 
half-session to do so, and (2) winning contention if both 
half-sessions attempt to begin a bracket simultane- 
ously. Contrast with bidder. See also bracket protocol. 


flow control. In SNA, the process of managing the rate 
at which data traffic passes between components of the 
network. The purpose of flow control is to optimize the 
rate of flow of message units, with minimum congestion 
in the network; that is, to neither overflow the buffers at 
the receiver or at intermediate routing nodes, nor leave 
the receiver waiting for more message units. See also 
adaptive session-level pacing, pacing, session-level 
pacing, and virtual route pacing. 
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FMD. Function management data. 
FMH. Function management header. 


focal point. An entry point that provides centralized 
management and control for other entry points for one 
or more network management categories. 


format identification (FID) field. In SNA, a field in each 
transmission header (TH) that indicates the format of 
the TH; that is, the presence or absence of certain 
fields. TH formats differ in accordance with the types of 
nodes between which they pass. The six FID types are: 


FIDO, used for traffic involving non-SNA devices 
between adjacent subarea nodes when either or 
both nodes do not support explicit route and virtual 
route protocols. 


FID1, used for traffic between adjacent subarea 
nodes when either or both nodes do not support 
explicit route and virtual route protocols. 


FID2, used for traffic between a subarea node and 
an adjacent type 2 peripheral node. 


FID3, used for traffic between a subarea node and 
an adjacent type 1 peripheral node. 


FID4, used for traffic between adjacent subarea 
nodes when both nodes support explicit route and 
virtual route protocols. 


FIDF, used for certain commands (for example, for 
transmission group control) sent between adjacent 
subarea nodes when both nodes support explicit 
route and virtual route protocols. 


formatted system services. A portion of VTAM that pro- 
vides certain system services as a result of receiving a 
field-formatted command, such as an Initiate or Termi- 
nate command. Contrast with unformatted system ser- 
vices (USS). See also field-formatted. 


frame. (1) The unit of transmission in some local area 
networks, including the IBM Token-Ring Network. It 
includes delimiters, control characters, irfformation, 
and checking characters. (2) In SDLC, the vehicle for 
every command, every response, and all information 
that is transmitted using SDLC procedures. 


full duplex (FDX). Synonym for dupiex. 


full-screen mode. A form of panel presentation in 
NetView where the contents of an entire terminal 
screen can be displayed at once. Full-screen mode can 
be used for fill-in-the-blanks prompting. Contrast with 
line mode. 


function management data (FMD). In SNA, a request 
unit (RU) category used for end-user data exchanged 
between logical units (LUs) and for requests and 
responses exchanged between network services com- 
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ponents of LUs, physical units (PUs), and system ser- 
vices control points (SSCPs). 


function management header (FMH). In SNA, one or 
more headers, optionally present in the leading request 
units (RUs) of an RU chain, that allow one half-session 
in an LU-LU session to: (1) select a destination at the 
session partner and control the way in which the end- 
user data it sends is handled at the destination, (2) 
change the destination or the characteristics of the data 
during the session, and (3) transmit between session 
partners status or user information about the destina- 
tion (for example, a program or device). Function man- 
agement headers (FMHs) can be used on LU-LU types 
1,4, and 6.2. 


gateway. The combination of machines and programs 
that provide address translation, name translation, and 
system services control point (SSCP) rerouting 
between independent SNA networks to allow those net- 
works to communicate. A gateway consists of one 
gateway NCP and at least one gateway SSCP. 


gateway NCP. An NCP that performs address trans- 
lation to allow cross-network session traffic. The 
gateway NCP connects two or more independent SNA 
networks. Synonymous with gateway node. 


gateway node. Synonym for gateway NCP. 


gateway SSCP. An SSCP that is capable of cross- 
network session initiation, termination, takedown, and 
session outage notification. A gateway SSCP is in 
session with the gateway NCP; it provides network 
name translation and assists the gateway NCP in 
setting up alias network addresses for cross-network 
sessions. 


GCS. Group control system. 


generalized path information unit trace (GPT). A record 
of the flow of path information units (PIUs) exchanged 
between the network control program and its attached 
resources. PIU trace records consist of up to 44 bytes 
of transmission header (TH), request/response header 
(RH), and request/response unit (RU) data. 


generation. The process of assembling and link editing 
definition statements so that resources can be identi- 
fied to all the necessary programs in a network. 


generic unbind. Synonym for session deactivation 
request. 


GPT. Generalized path information unit trace. 


group. In the NetView/PC program, to identify a set of 
application programs that are to run concurrently. 


group control system (GCS). A component of VM that 
provides multi-programming and shared memory 
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support to virtual machines. It is a saved system 
intended for use with SNA products. 


half-duplex. * In data communication, pertaining to an 
alternate, one way at a time, independent transmission. 
Contrast with duplex. 


half-session. In SNA, a component that provides func- 
tion management data (FMD) services, data flow 
control, and transmission control for one of the ses- 
sions of a network addressable unit (NAU). See also 
primary half-session and secondary half-session. 


hard copy. A printed copy of machine output in a visu- 
ally readable form; for example, printed reports, 
listings, documents, summaries, or network logs. 


hardware monitor. The component of the NetView 
program that helps identify network problems, such as 
hardware, software, and microcode, from a central 
control point using interactive display techniques. 


help panel. An online display that tells you how to use 
a command or another aspect of a product. See task 
panel. 


High Performance Option (HPO). A licensed program 
that is an extension of VM/SP. It provides performance 
and operation enhancements for large system environ- 
ments. 


hierarchy. In the NetView program, the resource types, 
display types, and data types that make up the organ- 
ization, or levels, in a network. 


host node. A node providing an application program 
interface (API) and a common application interface. 
See boundary node, node, peripheral node, subarea 
host node, and subarea node. See also boundary func- 
tion and node type. 


host processor. (1) (TC97) A processor that controls 
all or part of a user application network. (2) Ina 
network, the processing unit in which the data commu- 
nication access method resides. 


HPO. High Performance Option. 


hung terminal. A terminal to which a session is dis- 
rupted and that cannot send or receive commands. 


l-frame. A DLC frame type for transmitting data. Other 
DLC frame types are for control, status, and supervi- 
sory information. 


IMR. Intensive mode recording. 


IMS. Information Management System/Virtual Storage. 
Synonymous with /MS/VS. 
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IMS/VS. Information Management System/Virtual 
Storage. Synonym for /MS. 


inactive. Describes the state of a resource that has not 
been activated or for which the VARY INACT command 
has been issued. Contrast with active. See also inop- 

erative. 


independent LU. A logical unit (LU) that does not 
receive an ACTLU over a link. Such LUs can act as 
primary logical units (PLUs) or secondary logical units 
(SLUs) and can have one or more LU-LU sessions ata 
time. Contrast with dependent LU. 


information/Management. A feature of the 
Information/System licensed program that provides 
interactive systems management applications for 
problem, change, and configuration management. 


information Management System (IMS). A general 
purpose system whose full name is Information Man- 
agement System/Virtual Storage (IMS/VS). It enhances 
the capabilities of OS/VS for batch processing and tele- 
communication and allows users to access a computer- 
maintained data base through remote terminals. 


Information/System. An interactive retrieval program 
with related utilities designed to provide systems pro- 
grammers with keyword access to selected technical 
information contained in either of its companion pro- 
ducts, information/MVS or Information/VM-VSE. 


inhibited. In VTAM, pertaining to a logical unit (LU) that 
has indicated to its system services control point 
(SSCP) that it is not ready to establish LU-LU sessions. 
An initiate request for a session with an inhibited LU 
will be rejected by the SSCP. The LU can separately 
indicate whether this applies to its ability to act as a 
primary logical unit (PLU) or as a secondary logical 
unit (SLU). See also enabied and disabled. 


initiate. A network services request sent from a logical 
unit (LU) to a system services control point (SSCP) 
requesting that an LU-LU session be established. 


inoperative. The condition of a resource that has been 
active, but is not. The resource may have failed, 
received an INOP request, or is suspended while a 
reactivate command is being processed. See also 
inactive. 


input/output channel. (1) (ISO). In a data processing 
system, a functional unit that handles the transfer of 
data between internal and peripheral equipment. (2) In 
a computing system, a functional unit, controlled by a 
processor, that handles the transfer of data between 
processor storage and local peripheral devices. Syn- 
onymous with data channel. See channel. See also 
link, 
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installation exit routine. In VTAM, a user-written exit 
routine that can perform functions related to initiation 
and termination of sessions and is run as part of VTAM 
rather than as part of an application program. Exam- 
ples are the accounting, authorization, logon-interpret, 
and virtua! route selection exit routines. Contrast with 
application program exit routine. 


intensive mode recording (IMR). An NCP function that 
forces recording of temporary errors for a specified 
resource. 


interactive problem control system (IPCS). A VM 
facility for diagnosing problems, and managing 
problem information and status. IPCS is the principal 
means for diagnosing virtual machine dumps. 


interconnection. See SNA network interconnection. 


interface. * A shared boundary. An interface might be 
a hardware component to link two devices or it might 
be a portion of storage or registers accessed by two or 
more computer programs. 


intermediate routing function (IRF). In SNA, a path 
control capability in a subarea node that receives and 
routes path information units (PIUs) that neither origi- 
nate in nor are destined for network addressable units 
(NAUs) in the subarea. See also boundary function. 


intermediate routing node (IRN). In SNA, a subarea 
node with intermediate routing function. 


interpret table. In VTAM, an installation-defined corre- 
lation list that translates an argument into a string of 
eight characters. Interpret tables can be used to trans- 
late logon data into the name of an application program 
for which the logon is intended. 


inter-user communication vehicle (IUCV). A VM facility 
for passing data between virtual machines and VM 
components. 

IPCS. Interactive problem control system. 

IRN. Intermediate routing node. 

item. In CCP, any of the components, such as commu- 
nication controllers, lines, cluster controllers, and ter- 
minals, that comprise an IBM 3710 Network Controller 
configuration. 

lUCV. inter-user communication vehicle. 

JCL. Job control language. 

job control language (JCL). * A problem-oriented lan- 
guage designed to express statements in a job that are 


used to identify the job or describe its requirements to 
an operating system. 
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Kanji. A character set of symbols used for Japanese 
ideograms. See also double-byte character set. 


key-encrypting key. A key used in sessions with 
cryptography to encipher and decipher other keys. 
Contrast with data-encrypting key. 


keyword. (1) (TC97) A lexical unit that, in certain con- 
texts, characterizes some language construction. (2) * 
One of the predefined words of an artificial language. 
(3) One of the significant and informative words ina 
title or document that describes the content of that doc- 
ument. (4) A name or symbol! that identifies a param- 
eter. (5) A part of a command operand that consists of 
a specific character string (such as DSNAME=). See 
also definition statement and keyword operand. Con- 
trast with positional operand. 


keyword operand. An operand that consists of a 
keyword followed by one or more values (such as 
DSNAME =HELLO). See also definition statement. 
Contrast with positional operand. 


keyword parameter. (1) A parameter that consists of a 
keyword followed by one or more values. 


large message performance enhancement outbound 
(LMPEO). In VTAM, a facility in which VTAM reformats 
function management data (FMD) that exceed the 
maximum request unit (RU) size (as specified in the 
BIND) into a chain or partial chain of RUs. 


last-in-chain (LIC). A request unit (RU) whose request 
header (RH) end chain indicator is on and whose RH 
begin chain indicator is off. See also RU chain. 


LIC. (1) Last-in-chain. (2) In NCP, tine interface card. 
line. See communication line. 


line mode. A form of screen presentation in which the 
information is presented a line at a time in the message 
area of the terminal screen. Contrast with full-screen 
mode. 


line control. Synonym for data link control protocol. 


line group. One or more telecommunication lines of 
the same type that can be activated and deactivated as 
a unit. 


link. In SNA, the combination of the link connection and 
the link stations joining network nodes; for example: 

(1) a System/370 channel and its associated protocols, 
(2) a serial-by-bit connection under the control of Syn- 
chronous Data Link Control (SDLC). A link connection 
is the physical medium of transmission. A link, 
however, is both logical and physical. Synonymous 
with data link. See Figure 185 on page 697. 
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Figure 185. Links and Path Controls 


link connection. In SNA, the physical equipment pro- link connection segment. A portion of the configuration 
viding two-way communication between one link station that is located between two resources listed consec- 
and one or more other link stations; for example, a tele- utively in the service point command service (SPCS) 
communication line and data circuit terminating equip- query link configuration request list. 

ment (DCE). 


link level 2 test. See /ink test. 
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link station. (1) In SNA, the combination of hardware 
and software that allows a node to attach to and 
provide control for a link. (2) In VTAM, a named 
resource within a subarea node that represents 
another subarea node that is attached by a subarea 
link. In the resource hierarchy, the tink station is sub- 
ordinate to the subarea link. 


link test. In SNA, a test in which one link station 
returns data received from another link station without 
changing the data in order to test the operation of the 
link. Three tests can be made; they differ in the 
resources that are dedicated during the test. 


LMPEO. Large message performance enhancement 
outbound. 


load module. (ISO) A program unit that is suitable for 
loading into main storage for execution; it is usually the 
output of a linkage editor. 


local address. In SNA, an address used in a peripheral 
node in place of an SNA network address and trans- 
formed to or from an SNA network address by the 
boundary function in a subarea node. 


local area network (LAN). (1) A network in which a set 
of devices are connected to one another for communi- 
cation and that can be connected to a larger network. 
See also token ring. (2) A network in which communi- 
cations are limited to a moderately sized geographic 
area such as a single office building, warehouse, or 
campus, and which do not generally extend across 
public rights-of-way. Contrast with wide area network. 


local session identification (LSID). In SNA, a field ina 
FID3 (format identification type 3) transmission header 
that contains an indication of the type of session 
(SSCP-PU, SSCP-LU, or LU-LU) and the local address of 
the peripheral logical unit (LU) or physical unit (PU). 


logic error. In VTAM, an error condition that results 
from an invalid request; a program logic error. 


logical record. (1) (TC 97) A set of related data or 
words considered to be a record from a logical view- 
point. (2) A unit of information normally pertaining to a 
single subject; a logical record is that user record 
requested of or given to the data management function. 
See also basic conversation. 


logical unit (LU). In SNA, a port through which an end 
user accesses the SNA network and the functions pro- 
vided by system services control points (SSCPs). An 
LU can support at least two sessions—one with an 
SSCP and one with another LU—and may be capable of 
supporting many sessions with other LUs. See also 
network addressable unit (NAU), peripheral LU, phys- 
ical unit (PU), system services control point (SSCP), 
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primary logical unit (PLU), and secondary logical unit 
(SLU). 


logical unit (LU) services. In SNA, capabilities in a 
logical unit to: (1) receive requests from an end user 
and, in turn, issue requests to the system services 
control point (SSCP) in order to perform the requested 
functions, typically for session initiation; (2) receive 
requests from the SSCP, for example to activate LU-LU 
sessions via Bind Session requests; and (3) provide 
session presentation and other services for LU-LU ses- 
sions. See also physical unit (PU) services. 


logical unit (LU) 6.2. A type of logical unit that supports 
general communication between programs in a distrib- 
uted processing environment. LU 6.2 is characterized 
by (1) a peer relationship between session partners, (2) 
efficient utilization of a session for multiple trans- 
actions, (3) comprehensive end-to-end error proc- 
essing, and (4) a generic application program interface 
(API) consisting of structured verbs that are mapped 
into a product implementation. 


logmoade table. Synonym for logon mode table. 
log off. To request that a session be terminated. 


logoff. In VTAM, an unformatted session termination 
request. 


log on. To initiate a session. 


logon. In VTAM, an unformatted session initiation 
request for a session between two logical units. See 
automatic logon and simulated logon. See also 
Session-initiation request. 


logon data. In VTAM: (1) The user data portion of a 
field-formatted or unformatted session-initiation 
request. (2) The entire logon sequence or message 
from a logical unit (LU). Synonymous with logon 
message. 


logon message. Synonym for /ogon data. 

logon mode. In VTAM, a subset of session parameters 
specified in a logon mode table for communication with 
a logical unit. See also session parameters. 

logon mode table. In VTAM, a set of entries for one or 
more logon modes. Each logon mode is identified by a 
logon mode name. Synonymous with /jogmode table. 
logon-interpret routine. In VTAM, an installation exit 
routine, associated with an interpret table entry, that 
translates logon information. It may also verify the 
logon. 


LSID. Local session identification. 


LU. Logical unit. 
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LU 6.2 session. A session that is initiated by VTAM on 
behalf of a logical unit (LU) 6.2 application program, or 
a session initiated by a remote LU in which the applica- 
tion program specifies that VTAM is to control the 
session by using the APPCCMD macroinstruction. 


LU type. In SNA, the classification of an LU-LU session 
in terms of the specific subset of SNA protocols and 
options supported by the logical units (LUs) for that 
session, namely: 


The mandatory and optional values allowed in the 
session activation request. 


The usage of data stream controls, function man- 
agement headers (FMHs), request unit (RU) param- 
eters, and sense codes. 


Presentation services protocols such as those 
associated with FMH usage. 


LU types 0, 1, 2, 3, 4, 6.1, 6.2, and 7 are defined. 


LU-LU session. In SNA, a session between two logical 
units (LUs) in an SNA network. It provides communi- 
cation between two end users, or between an end user 
and an LU services component. 


LU-LU session type. A deprecated term for LU type. 
LU 6.2. Logical unit 6.2. 


macroinstruction. (1) An instruction that when exe- 
cuted causes the execution of a predefined sequence of 
instructions in the same source language. (2) In 
assembler programming, an assembler language state- 
ment that causes the assembler to process a prede- 
fined set of statements called a macro definition. The 
statements normally produced from the macro defi- 
nition replace the macroinstruction in the program. 

See also definition statement. 


maintain system history program (MSHP). A program 
that facilitates the process of installing and servicing a 
VSE system. 


maintenance and cperator subsystem (MOSS). A sub- 
system of an IBM communication controller, such as 
the 3725 or the 3720, that contains a processor and 
operates independently of the rest of the controller. !t 
loads and supervises the controller, runs problem 
determination procedures, and assists in maintaining 
both hardware and software. 


maintenance services. In SNA, one of the types of 
network services in system services control points 
(SSCPs) and physical units (PUs). Maintenance ser- 
vices provide facilities for testing links and nodes and 
for collecting and recording error information. See 
also configuration services, management services, 
network services, and session services. 
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major node. [n VTAM, a set of resources that can be 
activated and deactivated as a group. See node and 
minor node. 


management services. In SNA, one of the types of 
network services in control points (CPs) and physical 
units (PUs). Management services are the services 
provided to assist in the management of SNA networks, 
such as problem management, performance and 
accounting management, configuration management 
and change management. See also configuration ser- 
vices, maintenance services, network services, and 
session services. 


mandatory cryptographic session. Synonym for. 
required cryptographic session. 


mapped conversation. A type of conversation in which 
the data to be sent or received can be in a user-defined 
format. A logical unit (LU) that supports mapped con- 
versations converts the user data to a format suitable 
for the basic conversation protocol boundary. See also 
conversation and basic conversation. 


MOR. Miscellaneous data record. 


message. (1) (TC97) A group of characters and 
control bit sequences transferred as an entity. (2) In 
VTAM, the amount of function management data (FMD) 
transferred to VTAM by the application program with 
one SEND request. 


message unit. In SNA, the unit of data processed by 
any layer; for example, a basic information unit (BIU), a 
path information unit (PIU), or a request/response unit 
(RU). 


MIC. Middle-in-chain. 


middie-in-chain (MIC). A request unit (RU) whose 
request header (RH) begin chain indicator and RH end 
chain indicator are both off. See also AU chain. 


migration. Installing a new version or release of a 
program when an earlier version or release is already 
in place. 


minor node. in VTAM, a uniquely-defined resource 
within a major node. See node and major node. 


miscellaneous data record (MDR). A record of a 
network hardware error recorded by the NCP and sent 
to the VTAM host that owns the failing component. 
Then VTAM writes the error on the operating system 
error data set. 


modem. A device that modulates and demodulates 


signals transmitted over data communication facilities. 
The term is a contraction for modulator-demodulator. 
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mode name. A symbolic name for a set of session 
characteristics. For LU 6.2, a mode name and a 
partner LU name together define a group of parallel 
sessions having the same characteristics. 


MOSS. Maintenance and operator subsystem. 
MSHP. Maintain system history program. 


multiple-domain network. In SNA, a network with more 
than one system services contro! point (SSCP). Con- 
trast with single-domain network. 


Multiple Virtual Storage (MVS). An IBM licensed 
program whose full name is the Operating 
System/Virtual Storage (OS/VS) with Multiple Virtual 
Storage/System Product for System/370. It is a soft- 
ware operating system controlling the execution of pro- 
grams. 


Multiple Virtual Storage for Extended Architecture 
(MVS/XA). An IBM licensed program whose full name 
is the Operating System/Virtual Storage (OS/VS) with 
Multiple Virtual Storage/System Product for Extended 
Architecture. Extended architecture allows 31-bit 
storage addressing. MVS/XA is a software operating 
system controlling the execution of programs. 


MVS. Multiple Virtual Storage operating system. 


MVS/XA. Multiple Virtual Storage for Extended Archi- 
tecture operating system. 


name translation. In SNA network interconnection, 
converting logical unit names, logon mode table 
names, and class-of-service names used in one 
network into equivalent names to be used in another 
network. This function can be provided through 
NetView and invoked by a gateway system services 
control point (SSCP) when necessary. See also alias 
name. 


NAU. Network addressable unit. 
NC. Network control. 
NCCF. Network Communications Contro! Facility. 


NCP. (1) Network Control Program (IBM licensed 
program). lts full name is Advanced Communications 
Function for the Network Control Program. Synony- 
mous with ACF/NCP. (2) Network control program 
(general term). 


NCP major node. In VTAM, a set of minor nodes 
representing resources, such as lines and peripheral 
nodes, controlled by a network control program. See 
major node. 


negative response (NR). In SNA, a response indicating 
that a request did not arrive successfully or was not 
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processed successfully by the receiver. Contrast with 
positive response. See exception response. 


NetView. A system 370-based IBM licensed program 
used to monitor a network, manage it, and diagnose its 
problems. 


NetView/PC. A PC-based IBM licensed program 
through which application programs can be used to 
monitor, manage, and diagnose problems in [BM 
Token-Ring networks, non-SNA communication 
devices, and voice networks. 


network. (1) (TC97) An interconnected group of nodes. 
(2) In data processing, a user application network. See 
path control network, public network, SNA network, 
subarea network, type 2.1 network, and user- 
application network. 


network address. In SNA, an address, consisting of 
subarea and element fields, that identifies a link, a link 
station, or a network addressable unit. Subarea nodes 
use network addresses; peripheral nodes use local 
addresses. The boundary function in the subarea node 
to which a periphera! node is attached transforms local 
addresses to network addresses and vice versa. See 
focal address. See also network name. 


network address translation. In SNA network intercon- 
nection, conversion of the network address assigned to 
a logical unit in one network into an address in an adja- 
cent network. This function is provided by the gateway 
NCP that joins the two networks. See also alias 
network address and real network address. 


network addressable unit (NAU). In SNA, a logical unit, 
a physical unit, or a system services control point. It is 
the origin or the destination of information transmitted 
by the path control network. Each NAU has a network 
address that represents it to the path control network. 
See also network name, network address, and path 
control network. 


Network Communications Control Facility (NCCF). An 
IBM ticensed program that is a base for command 
processors that can monitor, control, automate, and 
improve the operations of a network. Its function is 
included and enhanced in NetView’s command facility. 


network control (NC). In SNA, an RU category used for 
requests and responses exchanged for such purposes 
as activating and deactivating explicit and virtual 
routes and sending load modules to adjacent periph- 
eral nodes. See also data flow control layer and 
session control. 


network control mode. The functions of a network 
control program that enable it to direct a communi- 
cation controller to perform activities such as polling, 
device addressing, dialing, and answering. Contrast 
with emulation mode. 
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Network Control Program (NCP). An IBM licensed 
program that provides communication controller 
support for single-domain, multiple-domain, and inter- 
connected network capability. Its full name is 
Advanced Communications Function for the Network 
Control Program. 


network control program. A program, generated by the 
user from a library of IBM-supplied modules, that con- 
trols the operation of a communication controller. 


network controller. A concentrator and protocol con- 
verter used with SDLC links. By converting protocols, 
which manage the way data is sent and received, the 
IBM 3710 Network Controller allows the use of non-SNA 
devices with an SNA host processor. 


network identifier (network iD). The network name 
defined to NCPs and hosts to indicate the name of the 
network in which they reside. It is unique across all 
communicating SNA networks. communication among 
domains. 


Network Logical Data Manager (NLDM). An IBM 
licensed program that collects and correlates session- 
related data and provides online access to this informa- 
tion. It runs as an NCCF communication network 
management (CNM) application program. Its function 
is included and enhanced in NetView’s session 
monitor. 


network management vector transport (NMVT). A man- 
agement services request/response unit (RU) that flows 
over an active session between physical unit manage- 
ment services and control point management services 
(SSCP-PU session). 


network name. (1) In SNA, the symbolic identifier by 
which end users refer to a network addressable unit 
(NAU), a link, or a link station. See also network 
address. (2) In a multiple-domain network, the name 
of the APPL statement defining a VTAM application 
program is its network name and it must be unique 
across domains. Contrast with ACB name. See unin- 
terpreted name. 


network operator. (1) A person or program respon- 
sible for controlling the operation of all or part of a 
network. (2) The person or program that controls all 
the domains in a multiple-domain network. Contrast 
with domain operator. 


Network Problem Determination Application (NPDA). 
An IBM licensed program that helps you identify 
network problems, such as hardware, software, and 
microcode, from a central control point using interac- 
tive display techniques. It runs as an NCCF communi- 
cation network management (CNM) application 
program. Its function is included and enhanced in 
NetView’s hardware monitor. 
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Network Routing Facility (NRF). An IBM licensed 
program that resides in the NCP, which provides a path 
for messages between terminals, and routes messages 
over this path without going through the host 
processor. 


network services (NS). In SNA, the services within 
network addressable units (NAUs) that control network 
operation through SSCP-SSCP, SSCP-PU, and SSCP-LU 
sessions. See configuration services, maintenance 
services, management services, and session services. 


network services (NS) header. In SNA, a 3-byte field in 
a function management data (FMD) request/response 
unit (RU) flowing in an SSCP-LU, SSCP-PU, or 
SSCP-SSCP session. The network services header is 
used primarily to identify the network services category 
of the request unit (RU) (for example, configuration ser- 
vices, session services) and the particular request 
code within a category. 


Network Terminal Option (NTO). An IBM licensed 
program used in conjunction with NCP that allows 
certain non-SNA devices to participate in sessions with 
SNA application programs in the host processor. NTO 
converts non-SNA protocol to SNA protocol when data 
is sent to the host from a non-SNA device and recon- 
verts SNA protocol to non-SNA protocol! when data is 
sent back to the device. 


NIB. Node initialization block. 
NLDM. Network Logical Data Manager. 
NMVT. Network management vector transport. 


node. (1) In SNA, an endpoint of a link or junction 
common to two or more links in a network. Nodes can 
be distributed to host processors, communication con- 
trollers, cluster controllers, or terminals. Nodes can 
vary in routing and other functional capabilities. See 
boundary node, host node, peripheral node, and 
subarea node (including illustration). (2) In VTAM, a 
point in a network defined by a symbolic name. See 
major node and minor node. 


node initialization block (NIB). In VTAM, a control block 
associated with a particular node or session that con- 
tains information used by the application program to 
identify the node or session and to indicate how com- 
munication requests on a session are to be handled by 
VTAM. 


node name. In VTAM, the symbolic name assigned to a 
specific major or minor node during network definition. 


node type. In SNA, a designation of a node according 
to the protocols it supports and the network address- 
able units (NAUs) that it can contain. Five types are 
defined: 1, 2.0, 2.1, 4, and 5. Type 1, type 2.0, and type 
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2.1 nodes are peripheral nodes; type 4 and type 5 
nodes are subarea nodes. See also type 2.1 node. 


Non-SNA Interconnection (NSI). An IBM licensed 
program that provides format identification (FID1/4) 
support for selected non-SNA facilities. Thus, it allows 
SNA and non-SNaA facilities to share SDLC links. It also 
allows the remote concentration of selected non-SNA 
devices along with SNA devices. 


nonswitched line. A telecommunication line on which 
connections do not have to be established by dialing. 
Contrast with switched line. 


no response. In SNA, a value in the form-of-response- 
requested field of the request header (RH) indicating 
that no response is to be returned to the request, 
whether or not the request is received and processed 
successfully. Contrast with definite response and 
exception response. 

normal flow. In SNA, a data flow designated in the 
transmission header (TH) that is used primarily to carry 
end-user data. The rate at which requests flow on the 
normal flow can be regulated by session-level pacing. 
Normal and expedited flows move in both the primary- 
to-secondary and secondary-to-primary directions. 
Contrast with expedited fiow. 

notify. A network services request that is sent by an 
SSCP to a logical! unit (LU) to inform the LU of the status 
of a procedure requested by the LU. 

NPDA. Network Problem Determination Application. 
NR. Negative response. 

NRF. Network Routing Facility. 

NS. Network services. 

NSI. Non-SNA Interconnection. 

NTO. Network Terminal Option. 

OAF. Origin address field. 

OBR. Outboard record. 

OIC. Only-in-chain. 

OLU. Origin logical unit. 


online. Stored in a computer and accessible from a ter- 
minal. 


only-in-chain (OIC). A request unit for which the 


request header (RH) begin chain indicator and RH end 
chain indicator are both on. See also RU chain. 
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operand. (1) (ISO) An entity on which an operation is 
performed. (2) * That which is operated upon. An 
operand is usually identified by an address part of an 
instruction. (3) Information entered with a command 
name to define the data on which a command 
processor operates and to control the execution of the 
command processor. (4) An expression to whose 
value an operator is applied. See also definition state- 
ment, keyword, keyword parameter, and parameter. 


operator. (1) In a language statement, the lexical 
entity that indicates the action to be performed on oper- 
ands. (2) A person who operates a machine. See 
network operator. See also definition statement. 


operator profile. In the NetView program, the 
resources and activities a network operator has control 
over. The statements defining these resources and 
activities are stored in a file that is activated when the 
operator logs on. 


orderly closedown. The orderly deactivation of VTAM 
and its domain. An orderly closedown does not com- 
plete until all application programs have closed their 
application control blocks (ACBs). Until then, 
RPL-based operations continue; however, no new ses- 
sions can be established and no new ACBs can be 
opened. Contrast with cance/ closedown and quick 
closedown. 


origin address field (OAF). In SNA, a field in a FIDO or 
FID1 transmission header that contains the address of 
the originating network addressable unit (NAU). Con- 
trast with destination address field. See also format 
identification (FID) field and local session identification 
(LSID). 


origin logical unit (OLU). The logical unit from which 
data is sent. Contrast with destination logical unit 
(DLU). 


outboard record. A record originated by I/O and com- 
munication components and supported by the access 
methods. It describes permanent errors or reports sta- 
tistical data. 


PAB. Process anchor block. 


pacing. In SNA, a technique by which a receiving com- 
ponent controls the rate of transmission of a sending 
component to prevent overrun or congestion. See 
session-level pacing, send pacing, and virtual route 
(VR) pacing. See also flow control. 


pacing group. In SNA, (1) The path information units 
(PIUs) that can be transmitted on a virtual route before 
a virtual-route pacing response is received, indicating 
that the virtual route receiver is ready to receive more 
PIUs on the route. Synonymous with window. (2) The 
requests that can be transmitted on the normal flow in 
one direction on a session before a session-level 
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pacing response is received, indicating that the 
receiver is ready to accept the next group of requests. 


pacing response. In SNA, an indicator that signifies a 
receiving component's readiness to accept another 
pacing group; the indicator is carried in a response 
header (RH) for session-level pacing, and in a trans- 
mission header (TH) for virtual route pacing. 


packet switching. (TC97) The process of routing and 
transferring data by means of addressed packets so 
that a channel is occupied only during the transmission 
of a packet; upon completion of the transmission, the 
channel is made available for the transfer of other 
packets. 


page. (1) The portion of a panel that is shown ona 
display surface at one time. (2) To move back and 
forth among the pages of a multiple-page panel. See 
also scroll. (3) (!SO) In a virtual storage system, a 
fixed-length block that has a virtual address and that 
can be transferred between real storage and auxiliary 
storage. (4) To transfer instructions, data, or both 
between real storage and external page or auxiliary 
storage. 


panel. (1) A formatted display of information that 
appears on a terminal screen. See also help panel and 
task pane/!. Contrast with screen. (2) In computer 
graphics, a display image that defines the locations and 
characteristics of display fields on a display surface. 


parameter. (1) (iSO) A variable that is given a constant 
value for a specified application and that may denote 
the application. (2) An item in a menu for which the 
user specifies a value or for which the system provides 
a value when the menu is interpreted. (3) Data passed 
to a program or procedure by a user or another 
program, namely as an operand in a language state- 
ment, as an item in a menu, or as a shared data struc- 
ture. See also keyword, keyword parameter, and 
operand. 


parallel tinks. In SNA, two or more links between adja- 
cent subarea nodes. 


parallel sessions. In SNA, two or more concurrently 
active sessions between the same two logical units 
(LUs) using different pairs of network addresses. Each 
session can have independent session parameters. 


partitioned emulation program (PEP) extension. A 
function of a network control program that enables a 
communication controller to operate some telecommu- 
nication lines in network control mode while simultane- 
ously operating others in emulation mode. 


path. (1) In SNA, the series of path control network 
components (path control and data link contro!) that are 
traversed by the information exchanged between two 
network addressable units (NAUs). See also explicit 
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route (ER), route extension, and virtual route (VR). 

(2) In VFAM when defining a switched major node, a 
potential dial-out port that can be used to reach that 
node. (3) In the NetView/PC program, a complete line 
in a configuration that contains all of the resources in 
the service point command service (SPCS) query link 
configuration request list. 


path control (PC). The function that routes message 
units between network addressable units (NAUs) in the 
network and provides the paths between them. It con- 
verts the BIUs from transmission control (possibly seg- 
menting them) into path information units (PIUs) and 
exchanges basic transmission units (BTUs) and one or 
more PlUs with data link control. Path control differs 
for peripheral nodes, which use local addresses for 
routing, and subarea nodes, which use network 
addresses for routing. See peripheral path control and 
subarea path control. See also link, peripheral node, 
and subarea node. 


path control (PC) layer. In SNA, the !ayer that manages 
the sharing of link resources of the SNA network and 
routes basic information units (BIUs) through it. See 
also BIU segment, blocking of PIUs, data link control 
layer, and transmission control layer. 


path control (PC) network. In SNA, the part of the SNA 
network that includes the data link control and path 
control layers. See SNA network and user application 
network. See also boundary function. 


path information unit (PIU). In SNA, a message unit 
consisting of a transmission header (TH) alone, or of a 
TH followed by a basic information unit (BIU) or a BIU 
segment. See also transmission header. 


PC. (1) Path control. (2) Personal Computer. Its full 
name is the IBM Personal Computer. 


PCID. Procedure-correlation identifier. 
PEP. Partitioned emulation program. 


performance class. In the NetView program, a 
description of an objective or commitment of perform- 
ance. It consists of a performance class name, 
boundary definitions, response time definition, 
response time ranges, and response time percentage 
objectives. Sessions may be assigned performance 
classes. 


performance error. Synonym for temporary error. 


peripheral host node. A node that provides an applica- 
tion program interface (API) for running application 
programs but does not provide SSCP functions and is 
not aware of the network configuration. The peripheral 
host node does not provide subarea node services. It 
has boundary function provided by Its adjacent 
subarea. See boundary node, host node, node, periph- 
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eral node, subarea host node, and subarea node. See 
also boundary function and node type. 


peripheral LU. In SNA, a logical unit representing a 
peripheral node. 


peripheral node. In SNA, a node that uses local 
addresses for routing and therefore is not affected by 
changes in network addresses. A peripheral node 
requires boundary-function assistance from an adja- 
cent subarea node. A peripheral node is a physical 
unit (PU) type 1, 2.0, or 2.1 node connected to a 


subarea node with boundary function within a subarea. 


See boundary node, host node, node, peripheral host 
node, subarea host node, and subarea node. See also 
boundary function and node type. 


peripheral path control. The function in a peripheral 
node that routes message units between units with 
local addresses and provides the paths between them. 
See path contro! and subarea path contro!. See also 


boundary function, peripheral node, and subarea node. 


peripheral PU. In SNA, a physical unit representing a 
peripheral node. 


permanent error. A resource error that cannot be 
resolved by error recovery programs. Contrast with 
temporary error. 


Personal Computer (PC). The IBM Personal Computer 
line of products including the 5150 and subsequent 
models. 


physical connection. In VTAM, a point-to-point con- 
nection or multipoint connection. Synonymous with 
connection. 


physical unit (PU). In SNA, a type of network address- 
able unit (NAU). A physical unit (PU) manages and 
monitors the resources (such as attached links) of a 
node, as requested by a system services contro! point 
(SSCP) through an SSCP-PU session. An SSCP acti- 
vates a session with the physical unit in order to indi- 
rectly manage, through the PU, resources of the node 
such as attached links. See also peripheral PU and 
subarea PU. 


physical unit (PU) services. in SNA, the components 
within a physical unit (PU) that provide configuration 
services and maintenance services for SSCP-PU ses- 
sions. See also /ogical unit (LU) services. 

PIU. Path information unit. 

plaintext. Synonym for clear data. 

PLU. Primary logical unit. 

polling. (1) * Interrogation of devices for purposes 


such as to avoid contention, to determine operational 
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status, or to determine readiness to send or receive 
data. (2) (TC97) The process whereby stations are 
invited, one at a time, to transmit. 


positional operand. An operand in a language state- 
ment that has a fixed position. See also definition 
statement. Contrast with keyword operand. 


positive response. A response indicating that a request 
was received and processed. Contrast with negative 
response. 


primary application program. In VTAM, an application 
program acting as the primary end of an LU-LU 
session. 


primary half-session. In SNA, the half-session that 
sends the session activation request. See also primary 
logical unit. Contrast with secondary half-session. 


primary logical unit (PLU). In SNA, the logical unit (LU) 
that contains the primary half-session for a particular 
LU-LU session. Each session must have a PLU and 
secondary logical unit (SLU). The PLU is the unit 
responsible for the bind and is the controlling LU for 
the session. A particular LU may contain both primary 
and secondary half-sessions for different active LU-LU 
sessions. Contrast with secondary logical unit (SLU). 


primary session. An extended recovery facility (XRF) 
session between the active application subsystem and 
a terminal user. 


problem determination. The process of identifying the 
source of a problem; for example, a program compo- 
nent, a machine failure, telecommunication facilities, 
user or contractor-installed programs or equipment, an 
environment failure such as a power loss, or a user 
error. 


process anchor block (PAB). In VTAM, a process 
scheduling services dispatch point. 


procedure-correlation identifier (PCID). In SNA, a value 
used by a control point to correlate requests and 
replies. 


profile. In the Conversational Monitor System (CMS) or 
the group contro! system (GCS), the characteristics 
defined by a PROFILE EXEC file that executes automat- 
ically after the system is loaded into a virtual machine. 
See also operator profile. 


program temporary fix (PTF). A temporary solution or 
bypass of a problem diagnosed by IBM in a current 
unaltered release of the program. 


protocol. (1) (CCITT/ITU) A specification for the format 
and relative timing of information exchanged between 
communicating parties. (2) (TC97) The set of rules 
governing the operation of functional units of a commu- 
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nication system that must be followed if communication 
is to be achieved. (3) In SNA, the meanings of, and the 
sequencing rules for, requests and responses used for 
managing the network, transferring data, and synchro- 
nizing the states of network components. See also 
bracket protocol. Synonymous with /ine control disci- 
pline and line discipline. See also link protocol. 


protocol boundary. (1) A synonym for the architec- 
turally defined logical unit (LU) 6.2 application program 
interface (API). (2) Any internal interface between 
components in a node. 


PTF. Program temporary fix. 
PU. Physical unit. 
PU type. Physical unit type. 


public network. A network established and operated by 
communication common carriers or telecommunication 
Administrations for the specific purpose of providing 
circuit-switched, packet-switched, and leased-circuit 
services to the public. Contrast with user-application 
network. 


PU-PU flow. In SNA, the exchange between physical 
units (PUs) of network control requests and responses. 


quick closedown. In VTAM, a closedown in which any 
RPL-based communication macroinstruction is termi- 
nated (posted complete with an error code) and no new 
sessions can be established and no new ACBs can be 
opened. See also cancel closedown and orderly ciose- 
down. 


quiesce. (1) * To bring a system or a device to a halt 
by rejecting new requests for work. (2) Ina VTAM 
application program, for one node to stop another node 
from sending synchronous-flow messages. 


RDT. Resource definition table. 

real name. The name by which a logical unit (LU), 
logon mode table, or class-of-service (COS) table is 
known within the SNA network in which it resides. 
real network address. The address by which a logical 
unit (LU) is known within the SNA network in which it 


resides. 


receive pacing. In SNA, the pacing of message units 
that the component is receiving. See also send pacing. 


RECFMS. Record formatted maintenance statistics. 
RECMS. Record maintenance statistics. 
Recommendation X.21 (Geneva 1980). A Consultative 


Committee on International Telegraph and Telephone 
(CCITT) recommendation for a general purpose inter- 
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face between data terminal equipment and data circuit 
equipment for synchronous operations on a public data 
network. 


Recommendation X.25 (Geneva 1980). A Consultative 
Committee on International Telegraph and Telephone 
(CCITT) recommendation for the interface between data 
terminal equipment and packet-switched data net- 
works. See also packet switching. 


recommended action. Procedures suggested by 
NetView that can be used to determine the causes of 
network problems. 


record formatted maintenance statistics (RECFMS). A 
statistical record built by an SNA controller and usually 
solicited by the host. 


record maintenance statistics (RECMS). An SNA error 
event record built from an NCP or fine error and sent 
unsolicited to the host. 


release. For VTAM, to relinquish control of resources 
(communication controllers or physical units). See also 
resource takeover. Contrast with acquire (2). 


remote. Concerning the peripheral parts of a network 
not centrally linked to the host processor and generally 
using telecommunication lines with public right-of-way. 


request header (RH). In SNA, control information pre- 
ceding a request unit (RU). See also request/response 
header (RH). 


request parameter list (RPL). In VTAM, a control block 
that contains the parameters necessary for processing 
a request for data transfer, for establishing or termi- 
nating a session, or for some other operation. 


request unit (RU). In SNA, a message unit that contains 
control information, end-user data, or both. 


request/response header (RH). !n SNA, contro! infor- 
mation, preceding a request/response unit (RU), that 
specifies the type of RU (request unit or response unit) 
and contains control information associated with that 
RU. 


request/response unit (RU). In SNA, a generic term for 
a request unit or a response unit. See also request unit 
(RU) and response unit. 


required cryptographic session. A cryptographic 
session in which all outbound data is enciphered and 
all inbound data is deciphered. Synonymous with man- 
datory cryptographic session. Contrast with selective 
cryptographic session and clear session. 


resource. (1) Any facility of the computing system or 


operating system required by a job or task, and 
including main storage, input/output devices, the proc- 
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essing unit, data sets, and contro! or processing pro- 
grams. (2) In the NetView program, any hardware or 
software that provides function to the network. 


resource definition table (RDT). In VTAM, a table that 
describes the characteristics of each node available to 
VTAM and associates each node with a network 
address. This is the main VTAM network configuration 
table. 


resource hierarchy. In VTAM, the relationship among 
network resources in which some resources are subor- 
dinate to others as a result of their position in the 
network structure and architecture; for example, the 
logical units (LUs) of a peripheral physical unit (PU) are 
subordinate to that PU, which, in turn, is subordinate to 
the link attaching it to its subarea node. 


resource takeover. In VTAM, action initiated by a 
network operator to transfer contro! of resources from 
one domain to another. See also acquire (2) and 
release. See takeover. 


resource types. in the NetView program, a concept to 
describe the organization of panels. Resource types 
are defined as central processing unit, channel, control 
unit, and {/O device for one category; and communi- 
cation controller, adapter, link, cluster controller, and 
terminal for another category. Resource types are 
combined with data types and display types to describe 
display organization. See also data types and display 
types. 


response header (RH). In SNA, a header, optionally fol- 
lowed by a response unit (RU), that indicates whether 
the response is positive or negative and that may 
contain a pacing response. See also negative 
response, pacing response, and positive response. 


response time. (1) The amount of time it takes after a 
user presses the enter key at the terminal until the 
reply appears at the terminal. (2) For response time 
monitoring, the time from the activation of a transaction 
until a response is received, according to the response 
time definition coded in the performance class. 


response time monitor (RTM). A feature available with 
certain hardware devices to allow measurement of 
response times, which may be collected and displayed 
by NetView. 


response unit (RU). In SNA, a message unit that 
acknowledges a request unit; it may contain prefix 
information received in a request unit. If positive, the 
response unit may contain additional! information (such 
as session parameters in response to Bind Session), or 
if negative, contains sense data defining the exception 
condition. 


return code. * A code [returned from a program] used 
to influence the execution of succeeding Instructlons. 
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REX. Route extension. 
RH. Request/response header. 


ring. A network configuration where a series of 
attaching devices are connected by unidirectional 
transmission links to form a closed path. 


route. See explicit route and virtual route. 


route extension (REX). In SNA, the path control 
network components, including a peripheral link, that 
make up the portion of a path between a subarea node 
and a network addressable unit (NAU) in an adjacent 
peripheral node. See also path, explicit route (ER), and 
virtual route (VR). 


RPL. Request parameter list. 


RPL exit routine. In VTAM, an application program exit 
routine whose address has been placed in the EXIT 
field of a request parameter list (RPL). VTAM invokes 
the routine to indicate that an asynchronous request 
has been completed. See EXLST exit routine. 


RPL-based macroinstruction. In VTAM, a macroin- 
struction whose parameters are specified by the user 
in a request parameter list. 


RTM. Response time monitor. 
RU. Request/response unit. 


RU chain. In SNA, a set of related request/response 
units (RUs) that are consecutively transmitted on a par- 
ticular normal or expedited data flow. The request RU 
chain is the unit of recovery: if one of the RUs in the 
chain cannot be processed, the entire chain is dis- 
carded. Each RU belongs to only one chain, which has 
a beginning and an end indicated by means of control 
bits In request/response headers within the RU chain. 
Each RU can be designated as first-in-chain (FIC), last- 
in-chain (LIC), middie-in-chain (MIC), or only-in-chain 
(OIC). Response units and expedited-flow request units 


are always sent as only-in-chain. 


SAW data. Synonym for session awareness (SAW) 
data. 


SC. Session control. 


scanner. (1) A device capable of electronically 
reviewing amounts of data and translating the data into 
a machine readable form. (2) For the 3725 communi- 
cation controller, a processor dedicated to controlling a 
small number of telecommunication lines. It provides 
the connection between the line interface coupler hard- 
ware and the central control unit. 
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scanner interface trace (SIT). A record of the activity 
within the communication scanner processor (CSP) for 
a specified data link between a 3725 Communication 
Controller and a resource. 


screen. An illuminated display surface; for example, 
the display surface of a CRT or plasma panel. Contrast 
with panel. 


scroll. To move all or part of the display image verti- 
cally to display data that cannot be observed within a 
single display image. See also page (2). 


SDLC. Synchronous Data Link Control. 


secondary half-session. In SNA, the half-session that 
receives the session-activation request. See also séc- 
ondary logical unit (SLU). Contrast with primary half- 
session. 


secondary logical unit (SLU). In SNA, the logical unit 
(LU) that contains the secondary half-session for a par- 
ticular LU-LU session. An LU may contain secondary 
and primary half-sessions for different active LU-LU 
sessions. Contrast with primary logical unit (PLU). 


secondary logical unit (SLU) key. A key-encrypting key 
used to protect a session cryptography key during its 
transmission to the secondary half-session. 


segment. See /ink connection segment. 


selective cryptographic session. A cryptographic 
session in which an application program is allowed to 
specify the request units to be enciphered. Contrast 
with required cryptographic session and clear session. 


send pacing. In SNA, pacing of message units that a 
component is sending. See also receive pacing. 


service point (SP). An entry point that supports appli- 
cations that provide network management for 
resources not under the direct contro! of itself as an 
entry point. Each resource is either under the direct 
control of another entry point or not under the direct 
control of any entry point. A service point accessing 
these resources is not required to use SNA sessions 
(unlike a focal point). A service point is needed when 
entry point support is not yet available for some 
network management function. 


service point command service (SPCS). An extension 
of the command facility in the NetView program that 
allows the host processor to communicate with a 
service point by using the communication network 
management (CNM) interface. 


session. in SNA, a logical connection between two 
network addressable units (NAUs) that can be acti- 
vated, tailored to provide various protocols, and deacti- 
vated, as requested. Each session is uniquely 
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identified in a transmission header (TH) by a pair of 
network addresses, identifying the origin and destina- 
tion NAUs of any transmissions exchanged during the 
session. See half-session, LU-LU session, SSCP-LU 
session, SSCP-PU session, and SSCP-SSCP session. 
See also LU-LU session type and PU-PU flow. 


session activation request. In SNA, a request that acti- 
vates a session between two network addressable units 
(NAUs) and specifies session parameters that control 
various protocols during session activity; for example, 
BIND and ACTPU. Contrast with session deactivation 
request. 


session awareness (SAW) data. Data collected by 
NetView about a session that includes the session type, 
the names of session partners, and information about 
the session activation status. It is collected for LU-LU, 
SSCP-LU, SSCP-PU, and SSCP-SSCP sessions and for 
non-SNA terminals not supported by NTO. It can be 
displayed in various forms, such as most recent ses- 
sions lists. 


session control (SC). In SNA, (1) One of the compo- 
nents of transmission control. Session control is used 
to purge data flowing in a session after an unrecover- 
able error occurs, to resynchronize the data flow after 
such an error, and to perform cryptographic verifica- 
tion. (2) A request unit (RU) category used for requests 
and responses exchanged between the session control 
components of a session and for session activation and 
deactivation requests and responses. 


session control in-bound processing exit (SCIP). A 
user exit that receives control when certain request 
units (RUs) are received by VTAM. 


session cryptography key. In SNA, a data encrypting 
key used to encipher and decipher function manage- 
ment data (FMD) requests transmitted in an LU-LU 
session that uses cryptography. 


session data. Data about a session, collected by 
NetView, that consists of session awareness data and 
session trace data. 


session deactivation request. In SNA, a request that 
deactivates a session between two network address- 
able units (NAUs); for example, UNBIND and DACTPU. 
Synonymous with generic unbind. Contrast with 
session activation request. 


session information block (SIB). A control block that 
contains information about a particular SNA session. 


session-initiation request. In SNA, an Initiate or logon 
request from a logical unit (LU) to a control point (CP) 

that an LU-LU session be activated. 

session-level pacing. In SNA, a flow control technique 


that permits a receiver to control the data transfer rate 
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(the rate at which it receives request units) on the 
normal flow. It is used to prevent overloading a 
receiver with unprocessed requests when the sender 
can generate requests faster than the receiver can 
process them. See also pacing and virtual route 
pacing. 


session limit. (1) In SNA, (a) the maximum number of 
concurrently active LU-LU sessions a particular logical 
unit can support; (b) the limit that determines how 
many sessions may be active between two logical units 
(LUs) that are using LU 6.2 protocols and a given mode 
name. Each partner LU is allocated a minimum share 
of contention-winner sessions within this limit. (2) In 
the network control program, the maximum number of 
concurrent line-scheduling sessions on a non-SDLC, 
multipoint line. 


session monitor. The component of NetView that col- 
lects and correlates session-related data and provides 
online access to this information. 


session parameters. In SNA, the parameters that 
specify or constrain the protocols (such as bracket pro- 
tocol and pacing) for a session between two network 
addressable units. See also logon mode. 


session partner. in SNA, one of the two network 
addressable units (NAUs) having an active session. 


session services. In SNA, one of the types of network 
services in the control point (CP) and in the logical unit 
(LU). These services provide facilities for an LU or a 
network operator to request that the SSCP initiate or 
terminate sessions between logical units. See config- 
uration services, maintenance services, and manage- 
ment services. 


session-termination request. In VTAM, a request that 
an LU-LU session be terminated. 


session trace. In the NetView program, the function 
that collects session trace data for sessions involving 
specified resource types or involving a specific 
resource. 


session trace data. Data relating to sessions that is 
collected by NetView whenever a session trace is 
started and that consists of session activation parame- 
ters, VTAM path information unit (PIU) data, and NCP 
data. 


shadow resource. In VTAM, an alternate represen- 
tation of a network resource that is retained as a defi- 
nition for possible future use. 


shared. Pertaining to the availability of a resource to 
more than one use at the same time. 


shutdown. To stop or quiesce a NetView/PC or a 
NetView/PC application program. 
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SIB. Session information block. 


simulated logon. A session-initiation request gener- 
ated when a VTAM application program issues a 
SIMLOGON macroinstruction. The request specifies a 
logical unit (LU) with which the application program 
wants a session in which the requesting application 
program will act as the primary logical unit (PLU). 


single-domain network. In SNA, a network with one 
system services control point (SSCP). Contrast with 
multiple-domain network. 


SIT. Scanner interface trace. 

SLU. Secondary logical unit. 

SMF. System management facility. 

SMP. System Modification Program. 

SMP/E. System Modification Program Extended. 
SNA. Systems Network Architecture. 


SNA network. The part of a user-application network 
that conforms to the formats and protocols of Systems 
Network Architecture. It enables reliable transfer of 
data among end users and provides protocols for con- 
trolling the resources of various network configura- 
tions. The SNA network consists of network 
addressable units (NAUs), boundary function compo- 
nents, and the path control network. 


SNA network interconnection. The connection, by gate- 
ways, of two or more independent SNA networks to 
allow communication between logical units in those 
networks. The individual SNA networks retain their 
independence. 


SP. Service point. 

SPCS. Service point command service. 

Span. In the NetView program, a user-defined group of 
network resources within a single domain. Each major 
or minor node is defined as belonging to one or more 
spans. See also span of control. 

span of control. The total network resources over 
which a particular network operator has control. All 
the network resources listed in spans associated 
through profile definition with a particular network 
operator are within that operator’s span of control. 


SS. Start-stop. 


SSCP. System services contro! point. 
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SSCP ID. in SNA, a number that uniquely identifies a 
system services control point (SSCP). The SSCP ID is _ 
used in session activation requests sent to physical 
units (PUs) and other SSCPs. 


SSCP rerouting. In SNA network interconnection, the 
technique used by the gateway system services control 
point (SSCP) to send session-initiation request units 
(RUs), by way of a series of SSCP-SSCP sessions, from 


one SSCP to another, until the owning SSCP is reached. 


SSCP-LU session. in SNA, a session between a system 
services control point (SSCP) and a logical unit (LU); 
the session enables the LU to request the SSCP to help 
initiate LU-LU sessions. 


SSCP-PU session. In SNA, a session between a system 
services control point (SSCP) and a physical unit (PU); 
SSCP-PU sessions allow SSCPs to send requests to 
and receive status information from individual nodes in 
order to control the network configuration. 


SSCP-SSCP session. In SNA, a session between the 
system services control point (SSCP) in one domain 
and the SSCP in another domain. An SSCP-SSCP 
session is used to initiate and terminate cross-domain 
LU-LU sessions. 


SSP. System Support Programs (IBM licensed 
program). Its full name is Advanced Communications 
Function for System Support Programs. Synonymous 
with ACF/SSP. 


ST. Session configuration screen abbreviation. 


start option. In VTAM, a user-specified or IBM-supplied 
option that determines certain conditions that are to 
exist during the time a VTAM system is operating. 

Start options can be predefined or specified when 
VTAM is started. 


statement. A language syntactic unit consisting of an 
operator, or other statement identifier, followed by one 
or more operands. See definition statement. 


statement identifier. The lexical! entity in a language 
statement that indicates the purpose of the statement, 
such as the action to be performed or the resource 
being defined. See also definition statement, definition 
statement identifier, and operator. 


station. (1) One of the input or output points of a 
network that uses communication facilities; for 
example, the telephone set in the telephone system or 
the point where the business machine interfaces with 
the channel on a leased private line. (2) One or more 
computers, terminals, or devices at a particular 
location. 
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status code. In VTAM, information on the status of a 
resource as shown in a 10-character state code; for 
example, STATEACTIV for active. 


status modifier. (1) in a System/370 status code, an 
indicator of the input/output (1/O) status. (2) In VTAM, 
a specific character appearing in specific positions of 
the status code; for example, B in the 10th position indi- 


‘cates a backup. 


subarea. A portion of the SNA network consisting of a 
subarea node, any attached peripheral nodes, and their 
associated resources. Within a subarea node, all 
network addressable units, links, and adjacent link 
Stations (in attached peripheral or subarea nodes) that 
are addressable within the subarea share a common 
subarea address and have distinct element addresses. 


subarea address. In SNA, a value in the subarea field 
of the network address that identifies a particular 
subarea. See also element address. 


subarea host node. A host node that provides both 
subarea function and an application program interface 
(API) for running application programs. It provides 
system services control point (SSCP) functions, 
subarea node services, and is aware of the network 
configuration. See boundary node, communication 
management configuration host node, data host node, 
host node, node, peripheral node, and subarea node. 
See also boundary function and node type. 


subarea link. In SNA, a link that connects two subarea 
nodes. See channel fink and link. 


subarea node. In SNA, a node that uses network 
addresses for routing and whose routing tables are 
therefore affected by changes in the configuration of 
the network. Subarea nodes can provide gateway func- 
tion, and boundary function support for peripheral 
nodes. Type 4 and type 5 nodes are subarea nodes. 
See boundary node, host node, node, peripheral node, 
and subarea host node. See also boundary function 
and node type. 


subarea path control. The function in a subarea node 
that routes message units between network address- 
able units (NAUs) and provides the paths between 
them. See path contro/ and peripheral path control. 
See also boundary function, peripheral node, and 
subarea node. 


subarea PU. In SNA, a physical unit (PU) in a subarea 
node. 


subsystem. A secondary or subordinate system, 


usually capable of operating independent of, or asyn- 
chronously with, a controlling system. 
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supervisor. The part of a control program that coordi- 
nates the use of resources and maintains the flow of 
processing unit operations. 


supervisor call (SVC). A request that serves as the 
interface into operating system functions, such as allo- 
cating storage. The SVC protects the operating system 
from inappropriate user entry. All operating system 
requests must be handled by SVCs. 


supervisor call (SVC) instruction. An instruction that 
interrupts the program being executed and passes 
control to the supervisor so that it can perform a spe- 
cific service indicated by the instruction. 


SVC. (1) Supervisor call. (2) Switched virtual circuit. 


switched line. A communication line in which the con- 
nection between the communication controller and a 
remote link station is established by dialing. 


switched major node. In VTAM, a major node whose 
minor nodes are physical units and logical units 
attached by switched SDLC links. 


switched virtual circuit (SVC). An X.25 circuit that is 
dynamically established when needed. The X.25 equiv- 
alent of a switched line. 


symptom string. A structured character string written 
to a file when VTAM detects certain error conditions. 


Synchronous Data Link Control (SDLC). A discipline for 
managing synchronous, code-transparent, serial-by-bit 
information transfer over a link connection. Trans- 
mission exchanges may be duplex or half-duplex over 
switched or nonswitched links. The configuration of the 
link connection may be point-to-point, multipoint, or 
loop. SDLC conforms to subsets of the Advanced Data 
Communication Control Procedures (ADCCP) of the 
American National Standards Institute and High-Level 
Data Link Control (HDLC) of the International Standards 
Organization. 


synchronous operation. In VTAM, a communication, or 
other operation in which VTAM, after receiving the 
request for the operation, does not return control to the 
program until the operation is completed. Contrast 
with asynchronous operation. 


synchronous request. In VTAM, a request for a syn- 
chronous operation. Contrast with asynchronous 
request. 


system management facility (SMF). A standard feature 
of MVS that collects and records a variety of system 
and job-related information. 


System Modification Program (SMP). An operating 
system component that facilitates the process of 
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installing and servicing an MVS system. See also 
System Modification Program Extended. 


System Modification Program Extended (SMP/E). An 
IBM licensed program that facilitates the process of 
installing and servicing an MVS system. See also 
System Modification Program. 


system services control point (SSCP). In SNA, a central 
location point within an SNA network for managing the 
configuration, coordinating network operator and 
problem determination requests, and providing direc- 
tory support and other session services for end users 
of the network. Multiple SSCPs, cooperating as peers, 
can divide the network into domains of control, with 
each SSCP having a hierarchical control relationship to 
the physical units and logical units within its domain. 


system services control point (SSCP) domain. The 
system services control point and the physical units 
(PUs), logical units (LUs), links, link stations and all the 
resources that the SSCP has the ability to control by 
means of activation requests and deactivation 
requests. 


Systems Network Architecture (SNA). The description 
of the logical structure, formats, protocols, and opera- 
tional sequences for transmitting information units 
through and controlling the configuration and operation 
of networks. 


System Support Programs (SSP). An IBM licensed 
program, made up of a collection of utilities and small 
programs, that supports the operation of the NCP. 


takeover. The process by which the failing active sub- 
system is released from its extended recovery facility 
(XRF) sessions with terminal users and replaced by an 
alternate subsystem. See resource takeover. 


TAP. Trace analysis program. Synonymous with 
ACFI/TAP. 


task. A basic unit of work to be accomplished by a 

computer. The task is usually specified to a control 
program in a multiprogramming or multiprocessing 
environment. 


task panel. Online display from which you communi- 
cate with the program in order to accomplish the pro- 
gram’s function, either by selecting an option provided 
on the panel or by entering an explicit command. See 
help panel. 


TC. Transmission control. 


TCAM. (1) Telecommunications Access Method. Syn- 
onymous with ACF/TCAM. (2) The IBM licensed 
program whose full name is Advanced Communi- 
cations Function for TCAM and that provides queued 
message handling. TCAM Versions 1 and 2 are access 
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methods, but TCAM Version 3 is a message handling 
subsystem. 


TCAS. Terminal control address space. 


telecommunication line. Any physical medium such as 
a wire or microwave beam, that is used to transmit 
data. Synonymous with transmission line. 


teletypewriter exchange service (TWX). Teletypewriter 
service in which suitably arranged teletypewriter 
stations are provided with lines to a central office for 
access to other such stations throughout the U.S. and 
Canada. Both baudot and ASCll-coded machines are 
used. Business machines may also be used with 
certain restrictions. 


temporary error. A resource failure that can be 
resolved by error recovery programs. Synonymous 
with performance error. Contrast with permanent 
error. 


terminal. A device that is capable of sending and 
receiving information over a link; it is usually equipped 
with a keyboard and some kind of display, such as a 
screen or a printer. 


terminal control address space (TCAS). The part of 
TSO/VTAM that provides logon services for TSO/VTAM 
users. 


TERMINATE. In SNA, a request unit that is sent by a 
logical unit (LU) to its system services control point 
(SSCP) to cause the SSCP to start a procedure to end 
one or more designated LU-LU sessions. 


TG. Transmission group. 
TH. Transmission header. 


threshold. In the NetView program, refers to a per- 
centage value set for a resource and compared to a 
caiculated error-to-traffic ratio. 


TIC. Token-ring interface coupler. 


time sharing option (TSO}. An optional configuration of 
the operating system that provides conversational time 
sharing from remote stations. 


time sharing option for VTAM (TSO/VTAM). An optional 
configuration of the operating system that provides 
conversational time sharing from remote stations ina 
network using VTAM. 


token. A sequence of bits passed from one device to 


another along the token ring. When the token has data 
appended to it, it becomes a frame. 
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token ring. A network with a ring topology that passes 
tokens from one attaching device to another. For 
example, the IBM Token-Ring Network. 


token-ring interface coupler (TIC). An adapter that can 
connect a 3725 Communication Controller to an IBM 
Token-Ring Network. 


trace analysis program (TAP). An SSP program 
service aid that assists in analyzing trace data 
produced by VTAM, TCAM, and NCP and provides 
network data traffic and network error reports. 


transaction program. (1) A program that is executed 
by or within an application program and performs ser- 
vices related to the processing of a transaction. (2) In 
VTAM, a program that performs services related to the 
processing of a transaction. One or more transaction 
programs may operate within a VTAM application 
program that is using the VTAM application program 
interface (API). In that situation, the transaction 
program would request services from the application 
program, using protocols defined by that application 
program. The application program, in turn, could 
request services from VTAM by issuing the APPCCMD 
macroinstruction. 


transmission control (TC) layer. In SNA, the layer 
within a half-session that synchronizes and paces 
session-level data traffic, checks session sequence 
numbers of requests, and enciphers and deciphers 
end-user data. Transmission control has two compo- 
nents: the connection point manager and session 
control. See also half-session. 


transmission contro! unit (TCU). A communication 
control unit whose operations are controlled solely by 
programmed instructions from the computing system to 
which the unit is attached; no program is stored or exe- 
cuted in the unit. Examples are the IBM 2702 and 2703 
Transmission Controls. Contrast with communication 
controller. 


transmission group (TG). In SNA, a group of links 
between adjacent subarea nodes, appearing as a 
single logical link for routing of messages. A trans- 
mission group may consist of one or more SDLC links 
(parallel links) or of a single System/370 channel. 


transmission header (TH). In SNA, control information, 
optionally followed by a basic information unit (BIU) or 
a BIU segment, that is created and used by path control 
to route message units and to control their flow within 
the network. See also path information unit. 


transmission line. Synonym for telecommunication 
line. 


transmission priority. In SNA, a rank assigned toa 


path information unit (PIU) that determines its preced- 
ence for being selected by the transmission group 
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control component of path control for forwarding to the 
next subarea node of the route used by the PIU. 


transmission subsystem component (TSC). The compo- 
nent of VTAM that comprises the transmission control, 
path control, and data link control layers of SNA. 


TSC. Transmission subsystem component. 
TSO. Time sharing option. 

TSO/VTAM. Time sharing option for VTAM. 
TWX. Teletypewriter exchange service. 


type 2.1 node (T2.1 node). A node that can attach to an 
SNA network as a peripheral node using the same pro- 
tocols as type 2.0 nodes. Type 2.1 nodes can be 
directly attached to one another using peer-to-peer pro- 
tocols. See end node, node, and subarea node. See 
also node type. 


type 2.1 node (T2.1 node) control point domain. The 
CP, its logical units (LUs), links, link stations, and all 
resources that it activates and deactivates. 


UNBIND. In SNA, a request to deactivate a session 
between two logical units (LUs). See also session 
deactivation request. Contrast with BIND. 


unformatted. In VTAM, pertaining to commands (such 
as LOGON or LOGOFF) entered by an end user and 
sent by a logical unit in character form. The character- 
coded command must be in the syntax defined in the 
user’s unformatted system services definition table. 
Synonymous with character-coded. Contrast with fie/d- 
formatted. 


unformatted system services (USS). In SNA products, a 
system services control point (SSCP) facility that trans- 
lates a character-coded request, such as a logon or 
logoff request into a field-formatted request for proc- 
essing by formatted system services and translates 
field-formatted replies and responses into character- 
coded requests for processing by a logical unit. Con- 
trast with formatted system services. See also 
converted command. 


uninterpreted name. In SNA, a character string that a 
system services control point (SSCP) is able to convert 
into the network name of a logical unit (LU). Typically, 
an uninterpreted name is used in a logon or Initiate 
request from a secondary logical unit (SLU) to identify 
the primary logical unit (PLU) with which the session is 
requested. 


upstream. In the direction of data flow from the end 
user to the host. Contrast with downstream. 


upstream device. For the IBM 3710 Network Controller, 
a device located in a network such that the device is 
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positioned between the 3710 and a host. A communi- 
cation controller upstream from the 3710 is an example 
of an upstream device. Contrast with downstream 
device. 


upstream line. For the IBM 3710 Network Controller, a 
telecommunication line attaching a 3710 to an 
upstream device. Contrast with downstream line. 


user. Anyone who requires the services of a com- 
puting system. 


user-application network. A configuration of data proc- 
essing products, such as processors, controllers, and 
terminals, established and operated by users for the 
purpose of data processing or information exchange, 
which may use services offered by communication 
common carriers or telecommunication Adminis- 
trations. Contrast with public network. 


user exit. A point in an |BM-supplied program at which 
a user routine may be given control. 


USS. Unformatted system services. 


value. (1) (TC97) A specific occurrence of an attribute, 
for example, “blue” for the attribute “color.” (2) A 
quantity assigned to a constant, a variable, a param- 
eter, or a symbol. 


variable. In the NetView program, a character string 
beginning with & that is coded in a command list and is 
assigned a value during execution of the command list. 


verb. (1) In SNA, the general name for a transaction 
program’s request for communication services. (2) In 
VTAM, a programming language element in the logical 
unit (LU) 6.2 application program interface (API) that 
causes an LU 6.2 function to be performed. 


virtual machine. A functional simulation of a computer 
and its associated devices. | 


Virtual Machine (VM). A licensed program whose full 
name is the Virtual Machine/System Product (VM/SP). 
It is a software operating system that manages the 
resources of a real processor to provide virtual 
machines to end users. As a time-sharing system 
control program, it consists of the virtual machine 
control program (CP), the conversational monitor 
system (CMS), the group control system (GCS), and the 
interactive problem control system (IPCS). 


virtual route (VR). In SNA, a logical connection (1) 
between two subarea nodes that is physically realized 
as a particular explicit route, or (2) that is contained 
wholly within a subarea node for intranode sessions. A 
virtual route between distinct subarea nodes imposes a 
transmission priority on the underlying explicit route, 
provides flow control through virtual-route pacing, and 
provides data integrity through sequence numbering of 
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path information units (PIUs). See also explicit route 
(ER), path, and route extension. 


virtual route (VR) pacing. in SNA, a flow control tech- 
nique used by the virtual route control component of 
path control at each end of a virtual route to control the 
rate at which path information units (PIUs) flow over the 
virtual route. VR pacing can be adjusted according to 
traffic congestion in any of the nodes along the route. 
See also pacing and session-level pacing. 


virtual route selection exit routine. In VTAM, an 
optional installation exit routine that modifies the list of 
virtual routes associated with a particular class of 
service before a route is selected for a requested 
LU-LU session. 


virtual storage. (ISO) The notion of storage space that 
may be regarded as addressable main storage by the 
user of a computer system in which virtual addresses 
are mapped into real addresses. The size of virtual 
storage is limited by the addressing scheme of the 
computer system and by the amount of auxiliary 
storage available, not by the actual number of main 
storage locations. 


Virtual Storage Access Method (VSAM). An access 
method for direct or sequential processing of fixed and 
variable-length records on direct access devices. The 
records in a VSAM data set or file can be organized in 
logical sequence by a key field (key sequence), in the 
physical sequence in which they are written on the data 
set or file (entry-sequence), or by relative-record 
number. 


Virtual Storage Extended (VSE). An IBM licensed 
orogram whose full name is the Virtual Storage 
Extended/Advanced Function. It is a software oper- 
ating system controlling the execution of programs. 


Virtual Telecommunications Access Method (VTAM). 
An IBM licensed program that controls communication 
and the flow of data in an SNA network. !t provides 
single-domain, multiple-domain, and interconnected 
network capability. 


VIT. VTAM internal trace. 

VM. Virtual Machine operating system. Its full name is 
Virtual Machine/System Product. Synonymous with 
VMI/SP. 

VM SNA console support (VSCS). A VTAM component 
for the VM environment that provides Systems Network 


Architecture (SNA) support. It allows SNA terminals to 
be virtual machine consoles. 


VM/SP. Virtual Machine/System Product operating 
system. Synonym for VM. 


VR. Virtual route. 
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VSAM. Virtual Storage Access Method. 
VSCS. VM SNA console support. 


VSE. Virtual Storage Extended operating system. Syn- 
onymous with VSE/AF. 


VSE/AF. Virtual Storage Extended/Advanced Function 
operating svstem. Synonym for VSE. 


VTAM. Virtual Telecommunications Access Method 
(IBM licensed program). Its full name is Advanced 
Communications Function for the Virtual Telecommuni- 
cations Access Method. Synonymous with ACF/VTAM. 


VTAM application program. A program that has 
opened an ACB to identify itself to VTAM and can now 
issue VTAM macroinstructions. 


VTAM definition. The process of defining the user 
application network to VTAM and modifying 
IBM-defined characteristics to suit the needs of the 
user. 


VTAM definition library. The operating system files or 
data sets that contain the definition statements and 
Start options filed during VTAM definition. 


VTAM internal trace (VIT). A trace used in VTAM to 
collect data on channel !/O, use of locks, and storage 
management services. 


VTAM operator. A person or program authorized to 
issue VTAM operator commands. See domain oper- 
ator, program operator, and network operator (2). 


VTAM operator command. A command used to monitor 
or control a VTAM domain. See also definition state- 
ment. 


VTAM Terminal 1/O Coordinator (VTIOC). The part of 
TSO/VTAM that converts TSO TGET, TPUT, TPG, and 
terminal control macroinstructions into SNA request 

units. 


VTIOC. VTAM Terminal 1/O Coordinator. 


wide area network. A network that provides data com- 
munication capability in geographic areas larger than 
those serviced by local area networks. Wide area net- 
works may extend across public rights-of-way. Con- 
trast with focal area network. 


window. (1) In SNA, synonym for pacing group. (2) On 
a visual display terminal, a small amount of information 
in a framed-in area on a panel that overlays part of the 
panel. 


wrap. In general, to go from the maximum to the 
minimum in computer storage. For example, the con- 
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tinuation of an operation from the maximum value in X.21. See Recommendation X.21 (Geneva 1980). 
storage to the first minimal value. 

X.25. See Recommendation X.25 (Geneva 1980). 
XID. Exchange identification. 

31-bit storage addressing. The storage address struc- 
XRF. Extended recovery facility. ture available in an MVS/XA operating system. 
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alternate screen size, PSERVIC coding 87 


AMDPRDMP utility 8 


APAR (authorized programming analysis report) 


API option 
VIT trace records created 
Alt 350 
Al2 352 
Al3 353 
1O1 418 
lO2 (MVS) 420 
102 (VM) 422 
lO2 (VSE) 420 
IO3 (MVS) 421 
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UP 485 
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ACI1 339 
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ACP1 342 
ACP2 344 
ACR1 342 
ACR2 344 
ACU1 345 
ACU2 345 
summary 309 
application program 
log 4 


performance group specification (TSO/VTAM) 


problems 6 
termination (VSCS) 124 
wait 33 
AREL trace record 354 
ASCB trace field 225 


asynchronous dispatch trace record 349 


ATT (attention) trace record 355 
AUTH operand (TSO/VTAM) 89 
authorized !O trace record 350 


available storage, VSCS, determining amount 


AXIT trace record 356 
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backspace key functions improperly 83 
BIND location 87 
BINFM, coding 74 
bracket in buffer contents trace output 80 
buffer contents trace 
confidential data 234 
description 232 
operation 233 
output 234 
when to use 232 
buffer extents, effect on performance (TSO/VTAM) 89 
buffer pool 
analyzing usage 237, 258 
control block relationships 494 
buffer use 
display 258 
trace 237 
trace format 
MVS 238 
VM 238 
VSE 240 
bus switching 299 
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CCl trace record 
NCSPL 359 
neither RUPE nor NCSPL 361 
RUPE 357 
CCO trace record 
NCSPL 359 
neither RUPE nor NCSPL 361 
RUPE 357 
change direction indicator in buffer contents trace 
output 80 
changing screen size in non-full-screen processing 87 
channel I/O (CIO) VIT option 
See CIO option 
channel programs 501 
channel-attachment major node, |/O trace 235 
character delete key functions improperly 83 
ClO option 
VIT trace records created 
ADPA 347 
ADPI 347 
ADPO 347 
ADP2 348 
ATT 355 
CONN 370 
DISC 385 
ERP (MVS) 391 
ERP (VM) 392, 398 
ERP (VSE) 395, 398 
HIO 405 
HIOP 406 
INT (MVS) 408 
INT (VM) 409, 412, 417 
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CIO option (continued) 
VIT trace records created (continued) 
INT (VSE) 414, 417 
LIC] 426 
LICO 426 
LICS 426 
PIC 443 
PKTI 446 
PKTO 446 
PKTX 447 
SIO 417, 468, 475 
SIO (MVS) 463 
SIO (VM) 466 
SIO (VSE) 472 
S!lO2 (MVS) 465 
summary 309 
Cli trace record 362 
Cl2 trace record 366 
Cl3 trace record 368 
Cl4 trace record 369 
CLSDST PASS, possible cause for failure 74 
CMS message prefix 104 
CMS mode, LU hangs during 126 
codes, CPCB operation 
colons as incorrect output (TSO/VTAM) 85 
color 
incorrect on screen (VSCS) 124 
3279 terminal (VSCS) 126 
commands 
incorrectly processed (VSCS) 147 
rejected (TSO/VTAM) 71 
to access printer (VSCS) 146 
to change screen size in non-full-screen processing 
(TSO/VTAM) 87 
communication adapter lines, error recording for 303 
communication scanner processor 
see CSP 
component!ID 3 
components 
connected toanLU 129 
in VSCS initialization 99 
concatenated input 83 
confidential data in buffer contents trace 234 
configuration dataset 9 
CONN trace record 370 
console log 4 
console mode, LU hangs during 126 
content of data stream is wrong (VSCS) 126 
control blocks 
formatted inadump 279, 280, 283 
ID codes 
for VSCS 659 
for VTAM_ 658 
TAB, PLB, and VLB inadump_ 119 
control operator control block (COPR) 282 
control register 0 bit 30, setting 102 
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COPR (control operator control block) 282 

CO1 trace record 362 

CO2 trace record 366 

CO3 trace record 368 

CO4 trace record 369 

CP message prefix 104 

CPCB operation codes 645 

CPMSG trace record 431 

CPPG trace record 371, 373 

CPPT trace record 371, 373 

CPRC trace record 377 

CPTRAP 223, 225 

CPU trace field 225 

CPWAIT macro 383, 384 

CPWT trace record 379, 381 

cross-domain logon problem 75 

CSI messages, issuing component 104 

CSP (communication scanner processor) 
dump 277 
trace 251 


current entry location in VSCS internal trace table 


current LU, location (VSCS) 121 


D 


data 
display problem (TSO/VTAM) 81 
incorrect content 
TSO/VTAM 71 
VSCS 126, 138 
VTAM 57 
incorrect length (TSO/VTAM) 71 
incorrect translation (TSO/VTAM) 85 
misplaced 
TSO/VTAM 84 
VSCS 138 
default 
logmode name in USS command _ 87 
screen size 87 
detected waits increase 72 
DISC trace record 385 
discard reason codes 661 
disconnection 
documentation requirements (VSCS) 117 
LU hangs during (VSCS) 129 
of LU during full-screen mode (VSCS) 124 
DISP trace record 386, 388 
dispatch trace entries 
IRBs 425 
PABs 386, 388 
redispatching 459 
SRBs_ 477 
dispatchable, condition of VSCS 118 
dispatcher 
trace, showing loop) 121 


work element queue, location in a VSCS dump 
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121 


dispatching priority, performance group 
specification 89 
DISPLAY command 
buffer pool use 258 
IDof TSO users 264 
NCP storage 263 
network ID 264 
network resource status 263 
route status 265 
route test 266 
trace status 264 
DMK messages, issuing component 104 
DMS messages, isSuing component 104 
document problems, howto 3 
documentation for hardware failures 8 
documentation problem 
procedure 66 
symptoms 14 
DOSVSDMP utility 8 
DPACE parameter of DIIGEN macro 142 
DSCD trace record 389 
DTI messages, issuing component 104 
DTICO1l message 103 
DTICO2I message 103 
DTICO3I message 106 
DTICO4I message 106 
DTICOSI message with return code 204 104 
DTICO7I message with IPTYPE=03 104 
DTICO9I message 105 
DTIC10!1 message 131 
DTIGEN macro 
DPACE parameter 142 
KPACE parameter 142 
PRTSHR parameter 146 
RPLNUM parameter 122 
specifying parameters in 107 
TIMEREL parameter 146 
VSAMLM parameter 143 
DTINSTRT load module 103 
DTII03I message 106 
DTIlI04I message 106 
DTIIO6I| message 106 
DTIIO7!| message 108 
DTII081 message 108 
DTIO9I message 108 
DTII10| message 108 
DTIl111 message 108 
DTIl13l message 109 
DTIl141 message 106, 109, 131 
DTIPATCH module 302 
DTIP141 message 120 
DTIP15I message 106, 110 
DTIS10!1 message 141 
DTIS311 message 118 
DTISS8I message 106 
DTIS99I message 106, 135 
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DTIUSERx selected incorrectly 108 
DTIVO1l message 106, 110 
DTIVO4I message 103 
DTIVO5I message 122 
DTIVO6I message 106 
DTIVO7I message 106 
DTIVO9I message 106 
DTIV12l message 141 
DUMP command 286 
dumps 
ABDUMP 279 
communication scanner processor (CSP) 277 
dynamic NCP 274 
maintenance and operator subsystem (MOSS) 277 
MVS 
abend 284 
formatting and printing 279 
SNAP 284 
stand-alone 284 
SVC 284 
VTAM control blocks formatted 279, 283 
network control program (NCP) dump 277 
using independent dump utility 277 
using VTAM dump facility 275 
static NCP 274 
tracing execution sequence of VTAM components 
in 302 
viewing online 8 
VM 
DUMP command 286 
formatting and printing 279 
GDUMP 286 
SDUMP 286 
VMDUMP command 286 
VTAM control blocks formatted 280, 283 
VSE 
DUMP command 287 
formatting and printing 279 
program-initiated dump 287 
SDAID dump facility 287 
stand-alone dump utility 287 
dynamic 
NCP dump 274 
trace utility 257 


echo test 300 
EDATS 126 


editing done by TPUT options 85 
enable SNA 102 
ERP trace record 
MVS 391 
VM 392, 398 
VSE 395, 398 
error recording 
communication adapter lines (VSE) 303 
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error recording (continued) 
hardware 300 
intensive mode 271 
LOGREC 4 
NCP 301 
NMVT alerts 288 
SYSREC 4 
error recovery procedures 
trace record 
MVS 391 
VM 392 
VSE 395 
ESC option, VIT trace records created 
ESC trace record 399 
escape character associated with incorrect screen 
size 88 
ETRACE 223 
event IDs (EIDs) 38 
exception responses 82 
execution sequence of VTAM components in a 
dump 302 
exit routines, trace entries for 
IRB 425 
RPL 455 
SRB 477 
TPEXIT 400 
user 479 
EXIT trace record 400 
extent of a loop, determining 121 
external trace, VSCS, limiting output 102 


F 


failing module problem 
procedure 6/7 
failure types 
See problem types 
FBLK trace record 401 
FEATUR2 keyword 126 
formatting and printing dump output (MVS) 279 
formatting trace output 
using CPTRAP and TRAPRED 225 
using PRDMP 224 
using TAP 224 
using TPRINT 227 
FREEBLK trace entry 401 
full-screen 
application, failure symptoms 124 
description of mode (TSO/VTAM) 82 
incorrect processing (TSO/VTAM) 71 
function error (TSO/VTAM) 82 
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GBLK trace record 403 
GCS (group control system) 

activation 102 

message prefix 104 
GDUMP command 286 
generalized PIU trace (GPT) 

description 245 

operation 245 

when to use 245 
generalized trace facility (GTF) 222 
GETBLK trace entry 403 
global I|UCV path severed 120 
GPT 

See generalized PIU trace 
GTF 

See generalized trace facility 
GTRACE macroinstruction 223 


hat 
tk 


HALT I/O trace record 405 
hard-copy log 4 
hardware 
error recording 300 
error records 
LOGREC 4 
SYSREC 4 
problem documentation 8 
highlighting does not work correctly (VSCS) 126 
HIO trace record 405 
HIOP (halt I/O) trace record 406 
hold option, effect on performance 89 
HOLDING condition precedes ahungLU 126 
host IRN (ISTIRN), !/O trace for 235 
host physical unit (ISTPUS) 
buffer contents trace for 233 
I/O trace for 235 
hung 
LU (VSCS) 
after message DTIC10!I 131 
after VARY INACT or FORCE command 132 
allLUs hung 119 
during console or CMS mode 126 
during full-screen mode 124 
during logoff or disconnect processing 129 
during logon 115 
how to recover 123 
one ormore LUs hung 123 
other problems 133 
preliminary procedure 118 
when switching modes 128 
session 33 
term defined 118 
terminal (TSO/VTAM) 
diagnosis procedure 79 
documentation requirements 79 
symptoms 71 
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/O pending 38 
1/O trace 
description 235 
operation 235 
output for MVS and VM) 236 
output for VSE 236 
when to use 235 
IBM Support Center 68 
IBMTEST command 300 
IKJEFTO1 utility 8 
IKJ608I message 71,75 
IKTO191 message /71 
IKTO24| message /1 
IKT104l message 75 
IMR (intensive mode recording) 271 
incorrect 
data 
length (TSO/VTAM) 71 
translation (TSO/VTAM) 85 
line prompting (TSO/VTAM) 71 
output 
diagnosis procedure 5/7 
symptoms 14 
TSO/VTAM 71, 84, 85 
VSCS 124, 138 
parameters, VSCS messages issued 107 
processing for a mode (TSO/VTAM) 71 
screen management (TSO/VTAM) 82 
screen size 
diagnosis procedure (TSO/VTAM) 86 
documentation requirements (TSO/VTAM) 
due to incorrect logmode (VSCS) 124 
non-SNA 3270 terminal 87 
while dialing to VTAM (VSCS) 144 
increase in 
detected waits 72 
swap-outs 72 
indications of 
full-screen application failure 124 
incorrect logmode definition (VSCS) 124 
OPCHECK 124 
initialization 
error messages issued (VSCS) 106 
messages issued (VSCS) 103 
never completes (VSCS) 102 
problems (VSCS) 101 
input is concatenated 83 
input mode processing is incorrect (TSO/VTAM) 


86 


71 


input/output problem determination (lOPD) facility 270 


INT trace records 
MVS 408 
VM 409, 412, 417 
VSE 412, 414, 417 
intensive mode recording 271 
interactive problem control subsystem 
See IPCS 
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intermediate routing node (IRN), I/O trace of 235 ' 
internal errors (VSCS) 135 


LICI (LAN interface control) trace record 426 
internal trace table location 


LICO (LAN interface control) trace record 426 


vo e 4214 LICS (LAN interface control) trace record 426 
i : mais 1214 limiting amount of VSCS external trace output 102 
vena. Cena, line delete key functions improperly 83 
line mode, description (TSO/VTAM) 82 
inadump 310 phon 


line trace 
description 246 
operation 247 
record format 
communication scanner type 2 247 
communication scanner type 3 249 
when to use 246 


instorage 309 
interpreting SVC trace entries 71 
invalid BIND in logon, detecting 74 
IOPD (input/output problem determination) facility 270 
lOl trace record 418 
102 trace record 


a Psi link level 2 test 8, 271 
VSE 420 link pack area (LPA) map 5 
103 t d link-edit (XREF) map 5 
at i LKEX trace record 428 
LKSH trace record 429 
VM 423 
LL2 
VSE 421 


See link level 2 test 
local SNA terminals, pacing values for 
(TSO/VTAM) 89 
location of 121 
BIND 87 
current entry in VSCS internal trace table 121 
dispatcher work element queue in a VSCS 
dump 121 
registers ina VSCS dump 102 
RPL poolinadump 122 
VSCS internal trace table 
inadump 121 
in storage 121 


IPCS (interactive problem control subsystem) 
dump formatting with GDUMP 280 
machine-readable dumps 8 

IPTYPEs 
complete list 105 
source of in VSCS messages 104 

IRBD trace record 424 

IRBX trace record 425 

IRN, trace of (host) 235 

IST messages, issuing component 104 

ISTPATCH module 302 

ISTPUS in traces 
buffer trace 233 


LOCK option 
ue Mage? “600 VIT trace records created 
IST400] message 75 LKEX 428 
IST804I message 75 LKSH 429 
IST805I message 75 summary 309 
lUCV (inter-user communication vehicle) ULKA 483 
option card, user ID for 101 UNLK 484 
pacing problem 142 locke 
description of 43 
a log ofconsole 4 
JOBN trace field 225 logical unit connection test 300 
logmode 
default name in USS command 87 
iS incorrectly defined, symptoms (VSCS) 124 
keyboard table entry in DLOGMOD 73 
See also hung LU logoff problems (VSCS) 117, 129 
character functions improperly 83 logon problems 
locked 124 TSO/VTAM 
KPACE parameter of DTIGEN macro 142 ABENDOAB 76 


cross-domain network 75 
diagnosis procedure 73 
documentation requirements 73 
fails for all terminals 74 
symptoms /71 
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logon problems (continued) 
VSCS 115 
LOGREC error recording dataset 4 
loop problems 
diagnosis procedure 46 
symptoms 14 
VSCS 
determining extent 121 
diagnosis procedure 118 
during initialization 107 
symptoms 121 
verifying 121 
loss of operator communications 131 
LOST trace record 430 
LPA (link pack area) map 5 
LQABs 38 
LU (logical unit) 
connection to other components (VSCS) 129 
control blocks TAB, PLB, and VLB_ 119 
disconnected (VSCS) 124 
recovery (VSCS) 130 
LU 6.2 message unit 435, 437 
LU-related problems, VSCS 
after message DTIC10] 131 
after VARY INACT or FORCE command 132 
allLUs are hung 119 
color terminal (3279) 126 
disconnected 124 
during console or CMS mode 126 
during full-screen mode 124 
during logoff or disconnect processing 129 
during logon 115 
global l1UCV path severed 120 
highlighting does not work correctly 126 
logoff and disconnect problems 117 
LU type 1 126 
no VTAM RECEIVE ANY RPLs active 122 
one ormore LUs hung 123 
other problems 133 
preliminary procedure for 118 
premature termination of user’s session 111 
Presentation Services loop causes hang 121 
printer sharing 146 
screen size is wrong 144 
SNA dial 144 
user exits 126 
VTAM Services causes a wait 120 
when switching modes) 128 
3279 color terminal 126 
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Mi 


maintenance and operator subsystem (MOSS) 
dump 2/77 
MAXDATA value, how to specify 83 
MDR (miscellaneous data record) 300 
Message Sent trace record 433 
messages 
‘NOT ACCEPTED’ 124 
issued for 3745 bus switching 299 
limitis reached 124 
module identification, modify 270 
prefixes 104 
problem 
procedure 53 
symptoms 14 
TSO/VTAM 
logon problems 71 
VSCS 
initialization, normal 103 
initialization, problems 106 
issued by Presentation Services 135 
issued by System Services 136 
issued by VTAM Services 136 
parameter problem 107 
source of return codes 104, 129 
miscellaneous data record (MDR) 300 
misplaced data 
See incorrect output 
mode switching errors (TSO/VTAM) 71 
MODEENT macro, description 74 
modified datatags 83 
MODIFY command 
dump 275 
lIOPD 270 
message module identification 270 
NCP intensive mode recording 2/71 
SDLC link level 2 test 271 
trace 222 
tuning statistics 272 
module name 
finding inadump 23 
finding in an internal trace (VIT) 313 
MORE condition precedes ahungLU 126 
MOSS dump 277 
MSG option 
VIT trace records created 
MSG 431 
MSGS 433 
OPER 441 
summary 309 
MSG trace record 431 
MSGMOD, MODIFY 270 
MSGS trace record 433 
MU1 trace record 435 
MU2 trace record 437 
MU3 trace record 438 
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MVS 
dumps 
abend 284 
formatting and printing 279 
SNAP 284 
Stand-alone 284 
SVC 284 
VTAM control blocks formatted 279, 283 
performance group specification 89 
trace fields 225 


N 


NCP (Network Control! Program) 
dumps 
dynamic 274 
independent dump utility 277 
Static 274 
VTAM dump facility 275 
error recording 301 
intensive mode recording 271 
Storage, displaying 263 
traces 
dynamic trace utility 257 
generalized PIU (GPT) 245 
line 246 
network controller line 250 
scanner interface (SIT) 251 
transmission group (TG) 252 
NetView program 
file 4 
for hardware failure 8 
hard-copy log 4 
network controller line trace 
operation 251 
Output 251 
when to use 250 
network flows 561 
network status, displaying 263 
NMVT alerts 
error recording 288 
non-SNA 3270 terminal, incorrect screen size 87 
NOT ACCEPTED message 124, 126 
NRM option 
VIT trace records created 
RCE 454 
NRSP trace record 439 
NVPACE operand (TSO/VTAM) 89 


722 VTAM Diagnosis 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


O 


OBR (outboard recorder) record 300 
online inspection of dumps 8 
OPCHECK symptoms) 124 
OPER trace record 441 
Operation checks 71 
operation codes, CPCB 645 
operator 
commands processed incorrectly (VSCS) 147 
console cannot communicate with VSCS 131 
option, TPUT, location of 84 
outboard recorder (OBR) record 300 
output 
queue, pointer to first element 80 
wait condition 89 
overview of normal VSCS initialization 99 


p 


PAB DISPATCH trace record 386, 388 
PABs (process anchor blocks) 36, 37 
pacing 
IUCV 142 
values for local SNA terminals (TSO/VTAM) 89 
parameters 
error messages (VSCS) 107 
specifying in DTIGEN macro 107 
patch area 
TSO/VTAM 302 
VSCS 302 
VTAM 302 
performance group 
how to specify 89 
location of 89 
performance problem 
diagnosis procedure 62, 89 
symptoms 14 
TSO/VTAM 
documentation requirements 89 
symptoms 72 
VSCS 143 
PIC (packet interface) trace record 443 
PIU discard reason codes 661 
PIU option 
VIT trace records created 
DSCD 389 
NRSP 439 
PIU 444 
summary 309 
PIU too long 83 
PlU trace record 444 
PKTI (packet) trace record 446 
PKTO (packet) trace record 446 
PKTX (packet extension) trace record 447 
PLB control block 119 
POST trace record 448 
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PROMP utility 224 
premature termination 
of VSCS_ 110 
of VSCS user's session 111 
Presentation Services 
large enabled loop 121 
messages issued by 135 
primary screen size, PSERVIC coding for 87 
printer 
commands for accessing (VSCS) 146 
not released (VSCS) 146 
sharing (VSCS) 146 
PRINTER command causes VTAM SIMLOGON 
failure 146 
printing output 
dumps 
using ABDUMP (MVS) 279 
using IPCS (VM) 280, 283 
using PROMP (MVS) 281 
using PRTDUMP (VM) 280 
using SADMP (MVS) 283 
using SDUMP (VM) 283 
traces 
using CPTRAP and TRAPRED 225 
using PRDMP 224 
using TAP 224 
using TPRINT 227 
problem determination commands 
DISPLAY 
buffer pool use 258 
NCP storage 263 
network status 263 
route status 265 
route test 266 
MODIFY 
intensive mode recording 271 
IOPD 270 
link level 2 test 271 
message module identification 270 
tuning statistics 272 
problem documentation 3 
problem symptoms 
abnormal end (abend) 14 
documentation 14 
incorrect output 14 
listed 14 
loop 14 
message 14 
performance 14 
program check 14 
wait 14 
problem types 
abend 19 
documentation 66 
failing module 67 
incorrect output 57 
loop 46 
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problem types (continued) 
message 53 
performance 62 
program check 25 
wait 29 
procedure for reporting problems 68 
procedures 
abnormalend 19 
documentation 66 
failing module 67 
incorrect output 57 
loop 46 
message 53 
performance 62 
program check 25 
reporting 68 
wait 29 
process anchor blocks (PABs) 36, 37 
processing is hung (TSO/VTAM) 71 
program 
-initiated dump 287 
check 
after message DTIC10! 131 
diagnosis procedure 25 
symptoms 14 
temporary fix (PTF) 3 
update tape (PUT) 3 
PROGxxx message 
TSO/VTAM 71 
VSCS 124 
PRTDUMP utility 8 
PRTSHR parameter of DTIGEN macro 146 
PSS option 
VIT trace records created 
ADSP 349 
AXiIT 356 
DISP 386, 388 
ESC 399 
EXIT 400 
IRBD 424 
IRBX 425 
POST 448 
QUE 4650, 452 
QUEN 453 
RESM 459 
SCHD 460, 462 
SRBD 476 
SRBX 477 
summary 309 
WAIT 489 
PTF (program temporary fix) eyecatcher 3 
PVM (pass-through VM virtual machine) 144 


index 


723 


C 

QREQ trace record 449 

QUE trace record 450, 452 

QUEN trace record 453 

QUEUED REQSTORE trace record 458 


IR 
RCE trace record 454 
RE trace record 455 
recovering an LU (VSCS) 130 
registers, location ina dump (VSCS) 102 
releasing a printer (VSCS) 146 
releasing VSCS LU 130 
RELS trace record 457 
repeated error record entries 
LOGREC 50 
SYSREC 50 
reporting procedure 68 
REQS trace record 458 
request parameter header 
See RPH 
reshow processing, description 82, 84 
RESM trace record 459 
response time slow (TSO/VTAM) 72 
resume address field in RPH 40 
RETRACE listing 9 
return codes, source (VSCS) 104, 129 
route 
Status, display 265 
test, display 266 
RPH (request parameter header) 
finding 40 
waiting 40 
RPL EXIT trace record 455 
RPL request type, location in dump of SOWA 77 
RPLFDBK2, location in dump of SOWA 77 
RPLFDB2, location in dump of SOWA 77 
RPLNUM parameter of DTIGEN macro 
default value 122 
description 122 
RPLRITNCD, location in dump of SOWA 77 
RPLs, VTAM RECEIVE ANY 
address ofeach 122 
description 122 
inactive 122 
location inadump 122 
total number 122 
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Save area 
conventions 304 
loop extent shown in 121 
scanner interface trace (SIT) 
description 251 
operation 252 
when touse 252 
SCHD trace record 460, 462 
screen management problems, TSO/VTAM 
diagnosis procedure 81 
documentation 81 
symptoms 71 
screen size 
changing, in non-full-screen processing 87 
default value 87 
incorrect 
TSO/VTAM _ 84, 86 
VSCS 124, 144 
PSERVIC coding 8/7 
TSO/VTAM problems 72 
SCRSIZE operand 87 
SDAID dump facility 287 
SDLC link level 2 test, modify 271 
SDUMP utility 286 
SDWA (system diagnostic work area) 5 
sense data 
in I/O trace 
MVS and VM 236 
VSE 237 
in transmission group trace 
MVS and VM) 255 
VSE 256 
service aids 
alert messages 288 
error recording for communication adapter 
lines 303 
hardware error recording 300 
logical unit connection test (IBMTEST) 300 
messages for 3745 bus switching 299 
NCP error recording 301 
NCP intensive mode recording 271 
patch area 301 
recording NMVT alerts in LOGREC or SYSREC 
VTAM 221 
session 
awareness data 9 
parameters, defining (TSO/VTAM) 73 
trace data 9 
SIMLOGON fails after PRINTER command (VSCS) 
SIO trace record 
MVS 463 
VM 466, 468, 475 
VSE 468, 472, 475 
S!lO2 trace record 
MVS 465 


288 


146 
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slow response time SSCP option (continued) , 
general procedure 62 VIT trace records created (continued) 
TSO/VTAM 72 CPPG 371, 373 
VSCS 143 CPPT 371,373 

SMS (buffer use) trace CPRC 377 
description 237 CPWT 379, 381 
format SRT 478 

MVS 238 summary 309 
VM 238 stand-alone dump 
VSE 240 MVS 284 
Operation 238 VSE 287 
when touse 238 START !/O trace record 
SMS option MVS 463, 465 
VIT trace records created VM 466 
AREL 354 VSE 472 
FBLK 401 starting address of the VSCS internal trace table 121 
GBLK 403 Static NCP dump 274 
QREQ 449 status, display of 263 
RELS 457 storage 
REQS 458 available, determining amount (VSCS) 107 
summary 309 shortage (VSCS) 111 
VTAL 487 storage related problem 
VTFR 488 VSCS 140 

SNA STSIZE macro, changing screen size with 87 
dial problems (VSCS) 144 SUMDUMP option 281 
enable 102 Support Center 68 
terminals, local, pacing values for (TSO/VTAM) 89 SVC dump 284 

SNAP swap count, incorrect incrementation 89 
abend 338 swap-outs increase 72 
dump 284 symptom string 
trace record, VIT 314 description 5 

source of IPTYPEs and return codes in VSCS MVS 21 

messages 104, 129 VM 21 

source of messages VSE 27 
CS! 104 | symptoms 
DMK 104 abend 14,71 
DMS 104 documentation problem 14 
DTI 104 full-screen application failure 124 
IST 104 hung terminal 71, 118 

SRBD trace record 476 incorrect logmode definition 124 

SRBX trace record 477 incorrect output 14 

SRT trace record 478 initialization problem 98 

SSCP option logon problem 71, 98 
VIT trace records created loop problem 14, 98, 121 

CCl for NCSPL 359 message problem 14, 98 

CClfor RUPE 357 OPCHECK 124 

CCl, neither RUPE nor NCSPL 361 performance problem 14, 72, 98 
CCO for NCSPL 359 printer sharing problem 98 

CCO for RUPE 357 program check 14 

CCO, neither RUPE nor NCSPL 361 screen management problems 71 
Cli 362 screen size problems 72 

Cil2 366 SNA dial problem 98 

Cl3 368 termination problem 98 

Cl4 369 wait problem 14, 98 

CO1 362 synchronous and asynchronous processing 120 
CQ2 366 SYSREC error recording dataset 4 
CO3 368 

CO4 369 
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system diagnostic work area (SDWA) 5 
System Services, messages issued by 136 
SYS1.LOGREC error recording dataset 4 


7 
TAB control block 119 
TAP (trace analysis program) 224 
techniques to recover a hung LU (VSCS) 123 
terminal 
cannotlogon 73,115 
definition statement 74 
device problem /7, 50, 59 
hung 79, 119, 123 
incorrect output problem 87, 138 
name, location in dump of SOWA 77 
pacing values 89 
recovery when hung) 123 
user echo test 300 
termination 
TSO/VTAM 
abend 7/7 
during logon 73 
VSCS 
abend 110 
immediately upon starting 103 
never completes 109 
premature 110 
unexpectedly, via operator command 112 
user's session 111 
TGET/TPUT trace 
See TSO/VTAM TGET/TPUT trace 
TIMEREL parameter of DTIGEN macro 146 
timing problems caused by synchronous and asynchro- 
nous processing 120 
TNSTAT (tuning statistics), modify 272 
TPESC trace record 399 
TPEXIT trace record 400 
TPIlO trace record 418 
TPLOCK EXCLUSIVE trace record 428 
TPLOCK SHARED trace record 429 
TPMSG trace record 431 
TPPOST trace record 448 
TPQUE NONE trace record 453 
TPQUE trace record 450, 452 
TPRINT utility 227 
TPSCHED trace record 460, 462 
TPUNLOCK ALL trace record 483 
TPUNLOCK trace record 484 
TPUT option 
editing 85 
location 84 
trace 
activating 222 
analysis program (TAP) 224 
buffer contents 232 
buffer use (SMS) 237 
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trace (continued) 
component execution sequence 302 
dynamic trace utility 257 


fields 
MVS-only 225 
VM-only 226 
generalized PIU (GPT) 245 
/O 235 
internal (VIT) 307 
line 246 
printing 
CPTRAP and TRAPRED 225 
PRDMP 224 
TPRINT 227 
records, VIT 


scanner interface (SIT) 251 
SMS (buffer use) 237 
summary 221, 222 
table header record (VIT) 310 
TGET/TPUT, for TSO/VTAM 241 
transmission group (TG) 252 
trace entries 
adapter 347, 348 
ClO error recovery 398 
halt !/O 406 
interrupt 412, 417 
LAN interface control 426 
packet 446 
packet extension 447 
packet interface 443 
Start '/O 468, 475 
traces 
See VTAM traces, NCP traces 
translation 
incorrect (TSO/VTAM) 85 
tables (TSO/VTAM) 85 
transmission group (TG) trace 
description 252 
operation 253 
output for MVS and VM) 254 
output for VSE 255 
when to use 252 
TRAPRED 
EFF2 option 247 
manual for information 226 
TRAPRED utility 
description 225 
TSO EDIT problems 71 
TSO TERMINAL command, changing screen size 
with 87 
TSO/VTAM problems 
ABENDOAB 77 
ABENDOAC 78 
ABENDOAD /78 
ABEND15D 78 
data misplaced onscreen 84 
data translated incorrectly 85 
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TSO/VTAM problems (continued) 
exception responses 82 
extra data 83 
first logon from a particular device fails 74 
first logon using USS commands fails 73 
function error 82 
hung terminal 79 
incorrect data translation 85 
incorrect screen size 86 
logon fails 73 
misplaced data onscreen 84 
missing data 83 
mode error (incorrect screen management) 
performance 89 
response time is slow 72 
screen is always wrong size 87 
screen is wrong size for mode 87 
screen management 81 
translation of data 85 
TSO/VTAM TGET/TPUT trace 
description 241 
operation 242 
output 242 
when to use 241 
tuning 89 
tuning statistics (TNSTAT), modify 272 
TVWABOQ 80 


U 


UE trace record 479 
ULKA trace record 483 
UNLK trace record 484 
UP trace record 485 
user Cannot log on 
TSO/VTAM 73 
VSCS_ 120 
user edit exits 
TSO/VTAM 
description 83 
when to use 85 
where to find list of 85 
VSCS 126 
USER EXIT trace record 479 
user ID for IUCV option card 101 
USER POST trace record 485 
USRxx trace field 225 
USS commands used in logon 73 
USS message 10 71 
USS message 7 71 
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M7 


v 
verifying a loop (VSCS) 121 
VIT 
See VTAM internal trace 
VLB control block 119 
VM 
directory, user ID for IUCV option card 101 
dumps 
DUMP command 286 
formatting and printing 279 
GDUMP_ 286 
SDUMP 286 
VMDUMP command 286 
VTAM control blocks formatted 280, 283 
trace fields 226 
VMBLOK status 132 
VMDUMP command 286 
VSAMLM parameter of DTIGEN macro 143 
VSCS 
initialization 
components involved 99 
loops 107 
messages indicating problems 106 
messages showing success’ 103 
source of IPTYPEs and return codes in 
messages 104 
internal problems 135 
internal trace table 
location inadump 121 
location instorage 121 
message prefix 104 
messages, source of return codes 106, 129 
overview of normal process 99 


PRINTER command causes VTAM SIMLOGON 


failure 146 
problems 
abends’ 110 


allLUs hung 119 

disconnect 117 

documentation requirements 93 

global IUCV path severed 120 

how totrace 93 

incorrect output 138 

incorrect parameters, messages for 107 
initialization 101 

IUCV pacing 142 


logoff. 117 
logon 115 
loop 118 


loop during initialization 107 
LU hangs after message DTIC10I 131 


LU hangs during console or CMS mode 126 


LU hangs during full-screen mode 124 

LU hangs during logoff or disconnect 
processing 129 

LU hangs when you switch modes 128 


LU stays hung after VARY INACT or FORCE 


command 132 


Index 


127 


VSCS (continued) 


problems (continued) 
misspelled or missing parameters 101 
no VTAM RECEIVE ANY RPLs active 122 
one or more LUs hung 123 
operator command does not complete 134 
operator command is rejected 147 
performance 143 
premature termination of user’s session 111 
premature termination of VSCS 110 
Presentation Services in large enabled loop 121 
printer sharing 146 
screen size is incorrect 144 
SNA dial 144 
storage 140 
storage shortage 101, 111 
symptoms 98 
termination 109 . 
termination immediately upon starting 103 
timing 120 
users cannotlogon 120 
VTAM Services 120 
wait 118 
storage available, determining amount 107 
termination messages 109 


VSE 


dumps 
DUMP command 287 
formatting and printing 279 
program-initiated dump 287 
SDAID dump facility 287 
stand-alone dump utility 287 


VTAL trace record 487 
VTAM 


buffer pool use 237 
channel programs 501 
commands for problem determination 257 
control blocks formatted in a dump 
MVS 279, 283 , 
VM 280, 283 
dump facility 275 
execution sequences 302 
locks 43 
message prefix 104 
PIU discard reason codes 661 
printer commands for VSCS 146 
RECEIVE ANY RPLs 
address ofeach 122 
description 122 
inactive 122 
locationinadump 122 
total number 122 
recovery machine, activating 102 
service aids 221 
SIMLOGON fails 146 
trace fields 
MVS-only fields 225 
VM-only fields 226 
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VTAM (continued) 


traces 
activating 222 
buffer contents 232 
buffer use (SMS) 237 
VO 235 
internal 307 
printing with CPTRAP and TRAPRED 225 
printing with PROMP 224 
printing with TAP 224 
printing with TPRINT 227 
SMS (buffer use) 237 
TGET/TPUT, for TSO/VTAM 241 
wait state indications 14 


VTAM internal trace (VIT) 339, 341, 344, 345, 346 


activation 

MODE=EXT 311 

MODE=INT 309 

OPTION operand 307 
deactivation 315 
module names in trace records 313 
record descriptions | 

ABND 338 

ACA1 339 

ACA2 341 

ACI1 339 

ACI2 341 

ACP1 342 

ACP2 344 

ACR1 342 

ACR2 344 

ACU1 345 

ACU2 345 

ADPA 347 

ADPI 347 

ADPO 347 

ADP2 348 

ADSP 342, 349 

All 350 

Al2 352 

Al3 353 

AREL 354 

ATT 355 

AXIT 356 

CCl for NCSPL 359 

CCI for neither RUPE nor NCSPL 361 

CCl for RUPE 357 

CCO for NCSPL 359 

CCO for neither RUPE nor NCSPL 361 

CCO for RUPE 357 

Cl1 362 

Cl2 366 

Cl3 368 

Cl4 369 

CONN 370 

CO1 362 

CO2 366 

CO3 368 
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VTAM internal trace (VIT) (continued) 
record descriptions (continued) 
CO4 369 
CPPG 371, 373 
CPPT 371, 373 
CPRC 377 
CPWT 379, 381 
DISC 385 
DISP 386, 388 
DSCD 389 
ERP forMVS_ 391 
ERP for VM 392, 398 
ERP for VSE 395, 398 
ESC 399 
EXIT 400 
FBLK 401 
GBLK 403 
HIO 405 
HIOP 406 
INT for MVS 408 
INT for VM 409, 412, 417 
INT for VSE 414, 417 
lO1 418 
102 for MVS 420 
1O2 for VM 422 
lO2 for VSE 420 
lO3 for MVS 421 
lO3 for VM 423 
lO3 for VSE 421 
IRBD 424 
IRBX 425 
LIC] 426 
LICO 426 
LICS 426 
LKEX 428 
LKSH 429 
LOST 430 
MSG 431 
MSGS 433 
MU1 435 
MU2 437 
MU3 438 
NRSP 439 
OPER 441 
PIC 443 
PIU 444 
PKTI 446 
PKTO 446 
PKTX 447 
POST 448 
QREQ 449 
QUE 450, 452 
QUEN 453 
RCE 454 
RE 455 
RELS 457 
REQS 458 
RESM 459 


LY30-5601-1 © Copyright IBM Corp. 1984, 1989 


VTAM internal trace (VIT) (continued) 
record descriptions (continued) 
SCHD 460, 462 
SIO 468, 475 
SIO for MVS 463 
S!O for VM 466 
SIO for VSE 472 
S!02 for MVS 465 
SRBD 476 
SRBX 477 
SRT 478 
UE 479 
ULKA 483 
UNLK 484 
UP 485 
VTAL 487 
VTFR 488 
WAIT 489 
record summary 315 
SNAP trace record 314 
trace table header record 310 
VTAM Services 
messages issued by 136 
task problem 120 
VTAMMAP control card 282 
VTFR trace record 488 


W 


wait 

application program 33 

caused by VTAM Services 120 

due to synchronous and asynchronous 

processing 120 

during VSCS termination 109 

option 89 

session 33 

symptoms 14, 121 
wait problem 

diagnosis procedure 29, 118 
WAIT trace record 489 
waiting 

request element (WRE) 38, 39 

RPH 40 
ways to recover ahung LU(VSCS) 123 
work areas (to trace execution sequences) 302 
wrapping of data onscreen 84 
WRE (waiting request element) 38, 39 
write control character in buffer contents trace 

output 80 


Index 


729 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


X 


XREF (link-edit) map 5 


Numerics 
3279 color terminal 126 
3720 communication controller, alert messages 


from 288 
3725 communication controller, alert messages 
from 288 


3745 communication controller 
alert messages from 288 
bus switching 299 
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Reader’s Comment Form 


VTAM 
Diagnosis 


Publication No. LY30-5601-1 


This manual is part of a library that serves as a reference source for systems 
analysts, programmers, and operators of IBM systems. You may use this form to 
communicate your comments about this publication, its organization, or subject 
matter, with the understanding that IBM may use or distribute whatever information 
you supply in any way it believes appropriate without incurring any obligation to 
you. 


Note: Copies of IBM Publications are not stocked at the location to which this form 
is addressed. Please direct any requests for copies of publications, or for 
assistance in using your IBM system, to your IBM representative or to the IBM 
branch office serving your locality. 


Possible topics for comment are: clarity, accuracy, completeness, organization, 
coding, retrieval, and legibility. 


Comments: 


What is your occupation? 


lf you wish a reply, give your name, company, mailing address, and date: 


Thank you for your cooperation. No postage stamp necessary if mailed in the 

U.S.A. (Elsewhere, an IBM office representative will be happy to forward your 

comments or you may mail directly to the address in the Edition Notice on the back 
_ of the title page.) 
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